> ## Documentation Index > Fetch the complete documentation index at: https://docs.salesfinity.ai/llms.txt > Use this file to discover all available pages before exploring further. # List tasks > The team’s sequencer task queue: the calls, emails and to-dos a cadence has produced, plus any one-off tasks reps created. Filter with `action=call` for the call queue. The team’s sequencer task queue: the calls, emails and to-dos a cadence has produced, plus any one-off tasks reps created. Filter with `action=call` for the call queue. ## OpenAPI ````yaml GET /v2/sequencer/tasks openapi: 3.0.1 info: title: Salesfinity API description: >- The Salesfinity API is a JSON-over-HTTPS REST API for the Salesfinity parallel dialer. Use it to manage contact lists, read call logs and AI call scores, pull team and SDR analytics, and enrich email addresses. Webhook subscriptions are managed in the Salesfinity application rather than through this API. ## Base URL All requests go to `https://client-api.salesfinity.co`. There is no separate sandbox host; see the developer portal for the recommended way to test safely. ## Authentication Every endpoint requires an API key sent in the `x-api-key` request header. Generate a key in the Salesfinity dashboard under **Settings -> Connections & API**. A key is scoped to a single team, and every response is filtered to that team. ```bash curl https://client-api.salesfinity.co/v1/team \ --header 'x-api-key: YOUR_API_KEY' ``` ## Errors Errors are always JSON and always use the same envelope, so a client can parse a failure the same way on every endpoint: ```json { "message": "Forbidden resource", "error": "Forbidden", "statusCode": 403 } ``` `statusCode` matches the HTTP status. `error` is the stable reason phrase to branch on. `message` is human readable, and is an array of strings when request validation fails. Note that a missing or invalid API key returns **403**, not 401. ## Pagination List endpoints accept `page` (1-based) and `limit` query parameters and return the matching page alongside the total count. The `limit` default varies by endpoint (10, 50, or 100) and is capped at 100 where a cap applies, so read the parameter schema on the operation itself. ## Rate limits Salesfinity does not currently publish a fixed request quota. Treat HTTP 429 as retryable and back off with exponential jitter. version: 1.0.0 termsOfService: https://salesfinity.ai/terms contact: name: Salesfinity Support email: hello@salesfinity.co url: https://support.salesfinity.ai license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://client-api.salesfinity.co description: Production. The only public Salesfinity API host. security: - ApiKeyAuth: [] tags: - name: Contact Lists description: >- Create, read, merge, and delete CSV contact lists, and add or remove the contacts inside them. - name: Teams description: >- Read the team that owns the API key, including its members, licenses, and statuses. - name: Dispositions description: Read the default and custom call outcomes configured for the team. - name: Sequences description: Read the sequences referenced by the team's call logs. - name: Call Logs description: >- Read the raw call history for the team, with filtering, sorting, and pagination. - name: Analytics description: Aggregated call metrics for the team, by contact list, and by SDR. - name: Snoozed Contacts description: Read and manage contacts that have been snoozed out of the dialing queue. - name: Follow-up Tasks description: Read follow-up tasks created from call outcomes. - name: Custom Fields description: Read the custom field mappings configured for the team. - name: Scored Calls description: Read AI-scored calls with per-facet scoring and coaching recommendations. - name: Notes description: >- Attach freeform notes to a person or company, list them, and pin the ones that matter. - name: Enrichment description: >- Look up phone numbers and work or personal email addresses for a LinkedIn profile, and check the team's remaining enrichment credits. - name: Sequencer Sequences description: >- Create, configure, enable and duplicate Sequencer cadences, and read their analytics. Distinct from the Sequences group, which lists sequence names observed on call logs from an external CRM. - name: Sequencer Steps description: The ordered steps that make up a cadence. - name: Sequencer Templates description: Reusable email subjects and bodies that email steps send from. - name: Sequencer Enrollments description: >- Contacts inside a sequence: where they are in the cadence, and the verbs that move them. - name: Sequencer Enrolment Runs description: >- Background enrolment of large batches, and the preview that shows what a batch would do. - name: Sequencer Tasks description: The rep task queue a cadence produces, plus standalone one-off tasks. - name: Sequencer Suppression description: >- The team do-not-contact list, checked before every enrolment and every send. - name: Sequencer Policies description: 'Rules of engagement: what may be enrolled, and what happens at each step.' - name: Sequencer Settings description: Team-level sequencer settings and sending mailboxes. Read-only. externalDocs: description: Salesfinity API documentation url: https://docs.salesfinity.ai paths: /v2/sequencer/tasks: get: tags: - Sequencer Tasks summary: List tasks description: >- The team’s sequencer task queue: the calls, emails and to-dos a cadence has produced, plus any one-off tasks reps created. Filter with `action=call` for the call queue. operationId: list-sequencer-tasks parameters: - name: limit required: false in: query description: Results per page. schema: maximum: 100 type: number - name: page required: false in: query description: Page number, 1-based. schema: default: 1 type: number - name: user_id required: false in: query description: >- Assignee to filter by, or `all` for every assignee on the team. Defaults to `all`. schema: type: string - name: state required: false in: query description: >- `pending` is the working queue. `held` means the enrollment is paused. The rest are terminal. schema: type: string enum: - pending - held - completed - skipped - expired - cancelled - name: action required: false in: query description: Use `call` to fetch the call queue. schema: type: string enum: - call - manual_email - generic - linkedin_connect - linkedin_message - linkedin_view - linkedin_interact - meeting - sms - name: sequence required: false in: query description: Only tasks belonging to this sequence. schema: type: string - name: origin required: false in: query description: Cadence tasks (`sequence`) or a rep’s own to-dos (`one_off`). schema: type: string enum: - sequence - one_off - name: contact required: false in: query description: Only tasks for this contact. schema: type: string - name: priority required: false in: query description: Only tasks in this priority band. schema: type: string enum: - high - medium - low - name: overdue required: false in: query description: Only tasks whose due date has passed. schema: type: boolean - name: due_before required: false in: query description: ISO 8601. Only tasks due before this instant. schema: type: string format: date-time - name: due_after required: false in: query description: ISO 8601. Only tasks due after this instant. schema: type: string format: date-time - name: search required: false in: query description: Matches the contact behind the task. schema: type: string - name: sort required: false in: query description: >- Applied server-side across the whole result set, not just the page you asked for. schema: default: due enum: - due - priority - action - prospect - company - sequence - last_activity type: string - name: direction required: false in: query description: Ignored by `due`, which is always oldest-first. schema: enum: - asc - desc type: string responses: '200': description: Success. content: application/json: schema: type: object description: A page of results. properties: data: type: array items: $ref: '#/components/schemas/SequencerTask' pagination: $ref: '#/components/schemas/SequencerPagination' required: - data - pagination '400': description: >- Validation failed. Check the request body and query parameters against the schema on this operation. `message` lists every field that failed validation. content: application/json: schema: $ref: '#/components/schemas/Error' example: message: - limit must not be greater than 100 error: Bad Request statusCode: 400 '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: SequencerTask: type: object description: A task in a rep queue. properties: _id: type: string description: 24-character hexadecimal id. example: 507f1f77bcf86cd799439011 user: type: string description: Assignee. contact: type: string description: 24-character hexadecimal id. example: 507f1f77bcf86cd799439011 sequence: type: string nullable: true description: Absent on a one-off task. sequence_step: type: string nullable: true origin: type: string enum: - sequence - one_off action: type: string enum: - call - manual_email - generic - linkedin_connect - linkedin_message - linkedin_view - linkedin_interact - meeting - sms state: type: string enum: - pending - held - completed - skipped - expired - cancelled priority: type: string enum: - high - medium - low subject: type: string nullable: true note: type: string nullable: true due_at: type: string format: date-time description: When the task is due. autoskip_at: type: string format: date-time nullable: true completed_at: type: string format: date-time nullable: true call_log: type: string nullable: true description: Set when a call task was resolved by a logged call. SequencerPagination: type: object description: >- Pagination for every list under /v2/sequencer. One shape across the whole namespace. properties: total: type: integer description: Total matching records. page: type: integer description: Current page, 1-based. limit: type: integer description: Page size used. pages: type: integer description: Total number of pages. required: - total - page - limit - pages Error: type: object title: Error description: >- The error envelope returned by every Salesfinity API error response. The shape is identical across all status codes and all endpoints. required: - message - error - statusCode properties: message: description: >- Human-readable description of the failure. A string for most errors, and an array of strings when request validation fails, with one entry per field that did not validate. oneOf: - type: string - type: array items: type: string example: Forbidden resource error: type: string description: >- Stable HTTP reason phrase for the status code. Branch on this rather than on `message`. example: Forbidden statusCode: type: integer format: int32 description: >- HTTP status code, repeated in the body so it survives transports that drop it. example: 403 example: message: Forbidden resource error: Forbidden statusCode: 403 responses: Forbidden: description: >- Forbidden. The `x-api-key` header is missing, malformed, revoked, or belongs to another team. Send a valid key in the `x-api-key` header. Salesfinity returns 403 (not 401) for a missing, malformed, revoked, or wrong-team key. content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Forbidden resource error: Forbidden statusCode: 403 TooManyRequests: description: >- Too Many Requests. The client is being throttled and should retry with backoff. Back off and retry with exponential jitter. Treat 429 as retryable. content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Too many requests error: Too Many Requests statusCode: 429 InternalServerError: description: >- Internal Server Error. Something went wrong on the Salesfinity side. Retry with exponential backoff. If it persists, contact hello@salesfinity.co with the request path and timestamp. content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Internal server error error: Internal Server Error statusCode: 500 securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Team-scoped API key generated in the Salesfinity dashboard under Settings -> Connections & API. A missing or invalid key returns HTTP 403. ````