List compliance jobs

GET /2/compliance/jobs
Bearer token

Returns recent compliance jobs for a given job type and optional job status

Query parameters

  • type string Required

    Type of compliance job to list.

    Values are tweets or users.

  • status string

    Status of compliance job to list.

    Values are created, in_progress, failed, or complete.

Responses

  • default

    The request has failed.

    Hide response attributes Show response attributes object
    • code integer(int32) Required
    • message string Required
  • 200

    List compliance jobs response

    Hide response attributes Show response attributes object
    • data array[object]

      At least 0 elements.

      Hide data attributes Show data attributes array[object]
      • id string Required

        Compliance Job ID

        Format should match the following pattern: ^[0-9]{1,19}$.

      • type string Required

        Type of compliance job to list.

        Values are tweets or users.

      • created_at string(date-time) Required

        Creation time of the compliance job.

      • upload_url string(uri) Required

        URL to which the user will upload their tweet or user IDs

      • upload_expires_at string(date-time) Required

        Expiration time of the upload URL

      • download_url string(uri) Required

        URL from which the user will retrieve their compliance results

      • download_expires_at string(date-time) Required

        Expiration time of the download URL

      • name string

        User-provided name for a compliance job

        Maximum length is 64.

      • status string Required

        Status of a compliance job

        Values are created, in_progress, failed, or complete.

    • errors array[object]

      An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).

      At least 0 elements.

      Hide errors attributes Show errors attributes array[object]
      • type string Required
      • title string Required
      • detail string
      • status integer
GET /2/compliance/jobs 
curl \
 -X GET https://api.twitter.com/2/compliance/jobs?type=tweets \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (default) 
{
  "code": 42,
  "message": "string"
}
Response examples (default) 
{
  "code": 42,
  "message": "string"
}
Response examples (200) 
{
  "data": [
    {
      "id": "1372966999991541762",
      "type": "tweets",
      "created_at": "2021-01-06T18:40:40.000Z",
      "upload_url": "https://example.com",
      "upload_expires_at": "2021-01-06T18:40:40.000Z",
      "download_url": "https://example.com",
      "download_expires_at": "2021-01-06T18:40:40.000Z",
      "name": "my-job",
      "status": "created"
    }
  ],
  "errors": [
    {
      "type": "string",
      "title": "string",
      "detail": "string",
      "status": 42
    }
  ]
}
Response examples (200) 
{
  "data": [
    {
      "id": "1372966999991541762",
      "type": "tweets",
      "created_at": "2021-01-06T18:40:40.000Z",
      "upload_url": "https://example.com",
      "upload_expires_at": "2021-01-06T18:40:40.000Z",
      "download_url": "https://example.com",
      "download_expires_at": "2021-01-06T18:40:40.000Z",
      "name": "my-job",
      "status": "created"
    }
  ],
  "errors": [
    {
      "type": "string",
      "title": "string",
      "detail": "string",
      "status": 42
    }
  ]
}