A2Z exposes the same objects you already model: tasks, assignments, qualifications, reviews, bonuses and events. This page is a preview of the v1 surface. Sandbox keys are issued to approved enterprise workspaces.
Each workspace gets API keys scoped to its programs. Send the key in the Authorization header. Keys can be rotated and restricted to an IP allow-list from the workspace settings.
curl https://api.a2zboard.com/v1/hits \
-H "Authorization: Bearer a2z_live_..." \
-H "Content-Type: application/json" \
-d '{
"HITTypeId": "HT_672O5S5Q481C0D0J5R37",
"HITLayoutId": "HL_INVOICE_FIELDS",
"HITLayoutParameters": [
{ "Name": "document_url", "Value": "https://.../inv-20419.pdf" },
{ "Name": "draft_total", "Value": "135.59" }
],
"MaxAssignments": 2,
"LifetimeInSeconds": 604800,
"RequesterAnnotation": "batch-2026-09-23",
"UniqueRequestToken": "inv-20419",
"Routing": { "Jurisdictions": ["EU"] }
}'
{
"HITId": "3XR7K2...",
"HITTypeId": "HT_672O5S5Q481C0D0J5R37",
"HITGroupId": "HG_1D5T1R3A0D1X6H70591K",
"HITStatus": "Assignable",
"Title": "Verify 3 fields on an invoice image",
"Reward": "0.12",
"MaxAssignments": 2,
"AssignmentDurationInSeconds": 3600,
"AutoApprovalDelayInSeconds": 259200,
"Expiration": "2026-09-30T09:41:02Z",
"NumberOfAssignmentsAvailable": 2,
"NumberOfAssignmentsPending": 0,
"NumberOfAssignmentsCompleted": 0,
"Routing": { "Jurisdictions": ["EU"], "Partners": ["ptr_baltic_process_partners"] }
}
Field names and statuses follow the Mechanical Turk API (HIT, HITType, Assignment, Qualification). Every object also carries the partner it was routed to. Worker identifiers are stable per program and pseudonymous to the enterprise; the partner holds the identity.
| Mechanical Turk operation | A2Z endpoint | Notes |
|---|---|---|
| CreateHITType | POST /v1/hit-types | Title, Description, Keywords, Reward, AssignmentDurationInSeconds, AutoApprovalDelayInSeconds, QualificationRequirements. Same limits as MTurk. |
| CreateHIT, CreateHITWithHITType | POST /v1/hits | HITLayoutId plus HITLayoutParameters or an HTMLQuestion, MaxAssignments, LifetimeInSeconds, UniqueRequestToken, plus Routing (jurisdictions, partners). |
| GetHIT, ListHITs, ListReviewableHITs | GET /v1/hitsGET /v1/hits/{id} | HITStatus values Assignable, Unassignable, Reviewable, Reviewing, Disposed and the three assignment counters. |
| UpdateExpirationForHIT, CreateAdditionalAssignmentsForHIT, DeleteHIT | POST /v1/hits/{id}/expirationPOST /v1/hits/{id}/assignmentsDELETE /v1/hits/{id} | Extend, expire early, add assignments or dispose. |
| ListAssignmentsForHIT, GetAssignment | GET /v1/hits/{id}/assignmentsGET /v1/assignments/{id} | Answers, accept and submit times, AssignmentStatus, and the partner behind each worker. |
| ApproveAssignment, RejectAssignment | POST /v1/assignments/{id}/approvePOST /v1/assignments/{id}/rejectPOST /v1/assignments/{id}/escalate | RequesterFeedback is required on reject. Escalate is new: the partner manager reviews. |
| CreateQualificationType, AssociateQualificationWithWorker, ListWorkersWithQualificationType | POST /v1/qualification-typesPOST /v1/qualification-types/{id}/workers | Tests with answer keys, auto-grant, and grants to whole partner teams. |
| SendBonus, ListBonusPayments | POST /v1/bonuses | Paid to the worker through their partner and itemised on your invoice. |
| NotifyWorkers, CreateWorkerBlock | POST /v1/workers/{id}/messagesPOST /v1/worker-blocks | Messages are delivered through the partner. Blocks apply per program. |
| UpdateNotificationSettings | POST /v1/webhooks | The MTurk event types, delivered as signed webhooks instead of SQS or SNS. |
| GetAccountBalance | GET /v1/invoices | No prepaid balance. Monthly invoices with per-program and per-partner breakdowns. |
| No equivalent | GET /v1/partners | Partners available to your programs, with jurisdictions and specialties. |
Events are signed and delivered with retries. Subscribe per workspace or per program.
HITCreated HITExpired HITReviewable HITExtended HITDisposed AssignmentAccepted AssignmentAbandoned AssignmentReturned AssignmentSubmitted AssignmentApproved AssignmentRejected AssignmentEscalated Ping
The sandbox mirrors production objects with a test partner and instant, deterministic completions so you can build your integration end to end. Sandbox keys come with an approved workspace.
Migrating an existing Mechanical Turk integration: keep your task layouts, replace the client, map HIT to task and qualification to qualification. Most teams need a day.