API documentation

GET /buyer_suppression_files/:id

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/buyer_suppression_files/:id

Get Suppression File by id.

Get the processing status, row counts, and any error message for a single Suppression File import by id.

Example Request

curl 'https://[your-subdomain].trackdrive.com/api/v1/buyer_suppression_files/a6af7847-1b1e-4760-ac0d-e1813a6d3a09' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "buyer_suppression_file": {
    "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "type": "BuyerSuppressionFile",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/buyer_suppression_files/a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "routes_edit_path": "/buyer_suppression_files/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
    "external_record_id": null,
    "company_id": 10001,
    "name": "Seeded Import",
    "buyer_suppression_id": 10002,
    "apply_block_or_unblock": "block",
    "import_file_url": null,
    "user_id": 10003,
    "status": "success",
    "caller_id_column_name": "caller_id",
    "error_message": null,
    "import_count": null,
    "total_count": null,
    "started_at": null,
    "stopped_at": null,
    "failed_at": null,
    "succeeded_at": "2026-01-15T15:30:00.000Z",
    "headers": null
  },
  "metadata": {
    "root": "buyer_suppression_file"
  }
}