INinstantly
BackgroundJob

List background job

Changed on

Requires one of the following scopes: background-jobs:read, background-jobs:all, all:read, all:all

get/api/v2/background-jobs

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/background-jobs
  • Auth
    HTTP bearer

Query parameters

limitinteger
Example:10

The number of items to return

starting_afterstring
Example:507f1f77bcf86cd799439011
idsstring
Example:676f3caadedbfe9abea3bab4

The ID of the job. Multiple IDs can be provided as a comma-separated list

included_idsstring
Example:676f3caadedbfe9abea3bab4

The ID of the job to be included in the response. Multiple IDs can be provided as a comma-separated list

excluded_idsstring
Example:676f3caadedbfe9abea3bab4

The ID of the job to be excluded from the response. Multiple IDs can be provided as a comma-separated list

type'move-leads' | 'import-leads' | 'export-leads' | 'update-warmup-accounts' | 'rename-variable' | 'broadcast-ai-generate' | 'broadcast-website-scrape' | 'import-subscribers-from-crm' | 'resync-subscriber-crm-tags' | 'journey-ai-build' | 'delete-leads'
Example:move-leads

The type of the job

entity_type'list' | 'campaign' | 'workspace' | 'broadcast' | 'subscriber-group-sync' | 'subscriber-group' | 'journey'
Example:list

The type of the entity

entity_idstring
Example:676f3caadedbfe9abea3bab4

The ID of the entity. Multiple IDs can be provided as a comma-separated list

statusstring
Example:pending,in-progress

The status of the job. Multiple statuses can be provided as a comma-separated list. Valid statuses are: pending, in-progress, success, failed, draining, paused, cancelled

sort_column'created_at' | 'updated_at'
Example:created_at

The column to sort the results by

sort_order'asc' | 'desc'
Example:desc

The order to sort the results by

Response

The list of Background Job

next_starting_afterstring

The filter for getting the next items after this one, this could either be a UUID, a timestamp, on an email depending on the specific API

Example response

{
  "items": [
    {
      "id": "675266e304a8e55b17f0228b",
      "workspace_id": "01a19e6f-5092-7ff5-a1b6-054e30b4b86f",
      "user_id": "01a19e6f-5092-7ff5-a1b6-054f63cc967a",
      "type": "move-leads",
      "entity_id": "01a19e6f-5092-7ff5-a1b6-055094f70e2b",
      "entity_type": "list",
      "data": {
        "moved_lead_emails": [
          "jane@example.com",
          "john@example.com"
        ],
        "skipped_duplicate_emails": [
          "jane@example.com"
        ],
        "skipped_in_other_campaigns_emails": [
          "jane@example.com"
        ],
        "skipped_blocklisted_emails": [
          "jane@example.com"
        ]
      },
      "status": "pending",
      "created_at": "2026-11-02T22:44:17.682Z",
      "updated_at": "2026-11-02T22:44:17.682Z"
    }
  ],
  "next_starting_after": "01a19e6f-8c04-7396-94eb-7b02bef9d46b"
}

Changes

  • c781051105a8Revision changes
    • warning

      added the new delete-leads enum value to the // response property for the response status

    • warning

      added the new journey enum value to the // response property for the response status

    • warning

      added the new journey-ai-build enum value to the // response property for the response status

    • info

      added the new enum value delete-leads to the query request parameter type

    • info

      added the new enum value journey to the query request parameter entity_type

    • info

      added the new enum value journey-ai-build to the query request parameter type

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status