List payroll migration imports for a legal entity | Deel

curl -G https://api.letsdeel.com/rest/gp/legal-entities/9a1f0e77-3c22-4b8d-8e64-2b0f5d9c1a44/payroll-migration-imports \
     -H "Authorization: Bearer <token>" \
     -d limit=20 \
     -d cursor=2f8c9a41-6b3e-4d0a-9f21-77c1e0a5b3d8

{
  "data": {
    "period": {
      "end": "2026-09-01",
      "start": "2026-01-01"
    },
    "imports": [
      {
        "type": "YTD_HISTORICAL_INGESTION",
        "files": [
          {
            "source": "EXTERNAL",
            "file_id": "V1StGXR8_Z5jdHi6B-myT",
            "file_name": "Revolut IE (YTD) 2026.csv",
            "file_size": 524288,
            "mime_type": "text/csv",
            "uploaded_at": "2026-01-15T09:30:00.000Z",
            "uploaded_by": 8313893
          }
        ],
        "status": "SUBMITTED",
        "import_id": "2f8c9a41-6b3e-4d0a-9f21-77c1e0a5b3d8",
        "created_at": "2026-01-15T09:30:00.000Z",
        "updated_at": "2026-01-15T09:30:00.000Z",
        "submitted_at": "2026-01-15T09:30:00.000Z",
        "submitted_by": 8313893,
        "legal_entity_id": "9a1f0e77-3c22-4b8d-8e64-2b0f5d9c1a44"
      }
    ]
  },
  "pagination": {
    "limit": 20,
    "has_more": false,
    "next_cursor": "2f8c9a41-6b3e-4d0a-9f21-77c1e0a5b3d8"
  }
}

Use this to check on the status of payroll migration imports for a legal entity before starting a new one — for example, to confirm previously submitted files have been reviewed, or to see files a partner already added before uploading more.

Token scopes: global-payroll:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

legal_entity_idstringRequiredformat: "uuid"

The unique identifier of the legal entity whose payroll migration imports to list.

Query parameters

limitintegerOptional1-50Defaults to 20

The maximum number of imports to return, between 1 and 50. Defaults to 20.

cursorstringOptional1-255 characters

An opaque cursor from the previous page’s pagination.next_cursor. Omit it for the first page.

Response

dataobject

The legal entity's payroll migration imports and the payroll data Deel already holds.

paginationobject

Pagination metadata for the page of imports returned.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error