> ## Documentation Index > Fetch the complete documentation index at: https://www.quo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get a task by task ID > Get a task by task ID ## OpenAPI ````yaml https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-2026-03-30-prod.json get /tasks/{taskId} openapi: 3.1.0 info: title: Quo Public API version: 1.0.0 description: API for connecting with Quo. contact: name: Quo Support email: support@quo.com url: https://support.quo.com/ termsOfService: https://www.quo.com/terms servers: - description: Production server url: https://api.quo.com security: - apiKey: [] tags: - description: Operations related to calls name: Calls - description: >- Operations related to call summaries, including AI-generated summaries and Sona voice assistant summaries name: Call Summaries - description: >- Operations related to call transcripts, including AI-generated transcripts and Sona voice assistant transcripts name: Call Transcripts - description: Operations related to contacts name: Contacts - description: Operations related to contact shares name: Contact Shares - description: Operations related to contact notes name: Contact Notes - description: Operations related to contact properties name: Contact Properties - description: Operations related to conversations name: Conversations - description: Operations related to workspace invitations name: Invites - description: Operations related to text messages name: Messages - description: Operations related to phone numbers name: Phone Numbers - description: Operations related to users name: Users - description: Operations related to webhooks name: Webhooks - description: >- Operations related to webhook events, including delivery history and test events name: Webhook Events paths: /tasks/{taskId}: get: tags: - Tasks summary: Get a task by task ID description: Get a task by task ID operationId: tasks.get parameters: - in: path name: taskId required: true schema: pattern: ^TK(.*)$ type: string - in: header name: Quo-Api-Version required: true schema: type: string enum: - '2026-03-30' description: 'API version header. Supported values: 2026-03-30' responses: '200': description: OK content: application/json: schema: type: object required: - data properties: data: type: object required: - taskId - orgId - createdBy - createdAt - status - revision properties: taskId: description: The unique identifier of a task examples: - TKb4164b7f9b3d40e79ea4af4f2298ed67 pattern: ^TK(.*)$ type: string example: TKb4164b7f9b3d40e79ea4af4f2298ed67 phoneNumberId: anyOf: - description: The unique identifier of Quo phone number. examples: - PN123bc pattern: ^PN(.*)$ type: string example: PN123bc - type: 'null' conversationId: anyOf: - description: >- The unique identifier of the conversation linked to this task. examples: - CN123abc pattern: ^CN(.*)$ type: string example: CN123abc - type: 'null' activityId: anyOf: - description: >- The unique identifier of the activity linked to this task. examples: - AC123abc pattern: ^AC(.*)$ type: string example: AC123abc - type: 'null' phoneNumberGroupId: anyOf: - description: >- The unique identifier of the group to which the Quo number belongs. examples: - '1234' type: string example: '1234' - type: 'null' orgId: description: >- The unique identifier of the organization linked to this task. examples: - OR123abc pattern: ^OR(.*)$ type: string example: OR123abc title: anyOf: - description: The title of the task examples: - Example task title type: string example: Example task title - type: 'null' description: anyOf: - description: The description of the task examples: - This is a task description. type: string example: This is a task description. - type: 'null' dueDate: anyOf: - format: date-time type: string - type: 'null' assignedTo: anyOf: - description: >- The unique identifier of the actor assigned to this task. examples: - SYU123abc - US123abc example: SYU123abc anyOf: - pattern: ^US(.*)$ type: string - pattern: ^SYU(.*)$ type: string - type: 'null' assignedBy: anyOf: - description: >- The unique identifier of the actor that assigned this task. examples: - SYU123abc - US123abc example: SYU123abc anyOf: - pattern: ^US(.*)$ type: string - pattern: ^SYU(.*)$ type: string - type: 'null' createdBy: description: >- The unique identifier of the actor/user that created the task. examples: - US123abc type: string example: US123abc createdAt: format: date-time type: string status: description: The status of a task examples: - open - completed example: open anyOf: - const: completed type: string - const: open type: string - const: deleted type: string revision: description: The revision number of the task examples: - 2 - 7 type: integer example: 2 '400': description: Bad Request content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: const: https://quo.com/docs type: string title: const: Bad Request type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: The input was invalid docs: https://quo.com/docs title: Bad Request trace: '6897907457496870895' '401': description: Unauthorized content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: const: https://quo.com/docs type: string title: const: Unauthorized type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: User is unauthorized to perform this action docs: https://quo.com/docs title: Unauthorized trace: '6897907457496870895' '403': description: Forbidden content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: const: https://quo.com/docs type: string title: const: Forbidden type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: User is forbidden to perform this action docs: https://quo.com/docs title: Forbidden trace: '6897907457496870895' '404': description: Not Found content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: const: https://quo.com/docs type: string title: const: Not Found type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: The contact was not found docs: https://quo.com/docs title: Not Found trace: '6897907457496870895' '500': description: Unknown Error content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: const: https://quo.com/docs type: string title: const: Unknown type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: An unknown error has occurred docs: https://quo.com/docs title: Unknown Error trace: '6897907457496870895' security: - apiKey: [] components: securitySchemes: apiKey: in: header name: Authorization type: apiKey ````