Request Export

curl --request POST \
  --url https://truckerfetch.com/api/v1/exports \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "window_days": 30,
  "edition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "filters": {
    "q": "<string>",
    "states": [
      "<string>"
    ],
    "classifications": [
      "<string>"
    ],
    "entity_types": [
      "<string>"
    ],
    "cargo": [
      "<string>"
    ],
    "filing_types": [
      "<string>"
    ],
    "insurer": "<string>",
    "census_status": [
      "<string>"
    ],
    "operations": [
      "<string>"
    ],
    "fleet": {
      "min": 4503599627370495,
      "max": 4503599627370495
    },
    "trucks": {
      "min": 4503599627370495,
      "max": 4503599627370495
    },
    "drivers": {
      "min": 4503599627370495,
      "max": 4503599627370495
    }
  },
  "usdots": [
    "<string>"
  ]
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    window_days: 30,
    edition_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    list_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    filters: {
      q: '<string>',
      states: ['<string>'],
      classifications: ['<string>'],
      entity_types: ['<string>'],
      cargo: ['<string>'],
      filing_types: ['<string>'],
      insurer: '<string>',
      census_status: ['<string>'],
      operations: ['<string>'],
      fleet: {min: 4503599627370495, max: 4503599627370495},
      trucks: {min: 4503599627370495, max: 4503599627370495},
      drivers: {min: 4503599627370495, max: 4503599627370495}
    },
    usdots: ['<string>']
  })
};

fetch('https://truckerfetch.com/api/v1/exports', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://truckerfetch.com/api/v1/exports"

payload = {
    "window_days": 30,
    "edition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "filters": {
        "q": "<string>",
        "states": ["<string>"],
        "classifications": ["<string>"],
        "entity_types": ["<string>"],
        "cargo": ["<string>"],
        "filing_types": ["<string>"],
        "insurer": "<string>",
        "census_status": ["<string>"],
        "operations": ["<string>"],
        "fleet": {
            "min": 4503599627370495,
            "max": 4503599627370495
        },
        "trucks": {
            "min": 4503599627370495,
            "max": 4503599627370495
        },
        "drivers": {
            "min": 4503599627370495,
            "max": 4503599627370495
        }
    },
    "usdots": ["<string>"]
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": "<unknown>",
  "meta": {},
  "next_cursor": "<string>"
}

API Reference

Request Export

Requires active Pro and an owner-scoped REST bearer key. Required scopes: exports:write, contacts:read. Creates an owner-scoped CSV job pinned to an authorized selection and published release. Save the payload and Idempotency-Key before submission. REST uses the user’s explicit selection authorization and has no MCP browser-approval step; hosted MCP additionally requires owner approval through confirmation_url and an identical retry with the same key. Renewal selections additionally require insurance:read and insurance availability; edition selections require current historical access. The sample selection is dashboard-only.

POST

/

exports

Request Export

curl --request POST \
  --url https://truckerfetch.com/api/v1/exports \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "window_days": 30,
  "edition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "filters": {
    "q": "<string>",
    "states": [
      "<string>"
    ],
    "classifications": [
      "<string>"
    ],
    "entity_types": [
      "<string>"
    ],
    "cargo": [
      "<string>"
    ],
    "filing_types": [
      "<string>"
    ],
    "insurer": "<string>",
    "census_status": [
      "<string>"
    ],
    "operations": [
      "<string>"
    ],
    "fleet": {
      "min": 4503599627370495,
      "max": 4503599627370495
    },
    "trucks": {
      "min": 4503599627370495,
      "max": 4503599627370495
    },
    "drivers": {
      "min": 4503599627370495,
      "max": 4503599627370495
    }
  },
  "usdots": [
    "<string>"
  ]
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    window_days: 30,
    edition_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    list_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    filters: {
      q: '<string>',
      states: ['<string>'],
      classifications: ['<string>'],
      entity_types: ['<string>'],
      cargo: ['<string>'],
      filing_types: ['<string>'],
      insurer: '<string>',
      census_status: ['<string>'],
      operations: ['<string>'],
      fleet: {min: 4503599627370495, max: 4503599627370495},
      trucks: {min: 4503599627370495, max: 4503599627370495},
      drivers: {min: 4503599627370495, max: 4503599627370495}
    },
    usdots: ['<string>']
  })
};

fetch('https://truckerfetch.com/api/v1/exports', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://truckerfetch.com/api/v1/exports"

payload = {
    "window_days": 30,
    "edition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "filters": {
        "q": "<string>",
        "states": ["<string>"],
        "classifications": ["<string>"],
        "entity_types": ["<string>"],
        "cargo": ["<string>"],
        "filing_types": ["<string>"],
        "insurer": "<string>",
        "census_status": ["<string>"],
        "operations": ["<string>"],
        "fleet": {
            "min": 4503599627370495,
            "max": 4503599627370495
        },
        "trucks": {
            "min": 4503599627370495,
            "max": 4503599627370495
        },
        "drivers": {
            "min": 4503599627370495,
            "max": 4503599627370495
        }
    },
    "usdots": ["<string>"]
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": "<unknown>",
  "meta": {},
  "next_cursor": "<string>"
}

Authorizations

Authorization

string

header

required

Owner-scoped Pro API key

Headers

Idempotency-Key

string

required

Persist this key with the exact request payload and reuse both after a timeout or confirmation; a changed payload conflicts.

Required string length: 8 - 128

Pattern: ^[-._:a-zA-Z0-9]{8,128}$

Body

application/json

Use edition_id only for edition scope and list_id only for list scope. Renewal scope requires date_basis and window_days; other scopes must omit them. Optional usdots limits the authorized selection.

scope

enum<string>

required

Available options:

edition,

catalog,

list,

renewals

date_basis

enum<string>

required if scope = renewals

Available options:

filing_anniversary,

estimated_policy_renewal,

verified_expiration,

filed_cancellation,

unknown

window_days

required if scope = renewals

edition_id

string<uuid>

required if scope = edition

Pattern:

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

list_id

string<uuid>

required if scope = list

Pattern:

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

filters

object

Show child attributes

usdots

string[]

Maximum array length: 25000

Pattern: ^[0-9]{1,16}$

Response

Authorized operation result

data

any

required

meta

object

required

next_cursor

string