Skip to main content
Retrieve all active registration tasks for a corporation. Tasks represent actions that need to be completed as part of the registration process — such as document submission, information verification, or Commenda team review. 
GET /registrations/v2/tasks

​
Query parameters

​
corporation_id
string
required
The corporation UUID to retrieve tasks for.

​
Response

Returns a list of tasks associated with the corporation’s V2 registrations.
FieldTypeDescription
idstringUnique task identifier
task_idstringTask type identifier
titlestringHuman-readable description of what the task requires
statusstringCurrent task status
assignee_typestringWho is responsible (USER or AGENT)
registration_idstringThe registration this task belongs to
registration_namestringHuman-readable name of the registration
service_request_idstringAssociated service request identifier
curl --request GET \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/tasks?corporation_id=550e8400-e29b-41d4-a716-446655440000' \
  --header 'Authorization: Bearer <your_token>'

{
  "tasks": [
    {
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "task_id": "SUBMIT_DOCUMENTS",
      "title": "Submit required documents for California Sales Tax",
      "status": "PENDING",
      "assignee_type": "USER",
      "registration_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "registration_name": "California Sales and Use Tax",
      "service_request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    },
    {
      "id": "e290f1ee-6c54-4b01-90e6-d701748f0852",
      "task_id": "REVIEW_APPLICATION",
      "title": "Commenda team is reviewing the registration",
      "status": "IN_PROGRESS",
      "assignee_type": "AGENT",
      "registration_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "registration_name": "California Sales and Use Tax",
      "service_request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    }
  ]
}

​
Task types

Tasks are automatically created when you initiate a registration through Commenda’s managed process. Each task is assigned to either you (USER) or the Commenda team (AGENT).
  • User tasks require action from you, such as providing additional information or uploading documents
  • Agent tasks are handled by the Commenda team and require no action from you — they serve as progress indicators
Poll this endpoint to track the progress of registrations that are being processed by Commenda. When all tasks for a registration are complete, the registration status will be updated accordingly.