List payroll migration imports for a legal entity

GET

/gp/legal-entities/:legal_entity_id/payroll-migration-imports

GET

/rest/gp/legal-entities/:legal_entity_id/payroll-migration-imports

$ 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

1 {
2   "data": {
3     "period": {
4       "end": "2026-09-01",
5       "start": "2026-01-01"
6     },
7     "imports": [
8       {
9         "type": "YTD_HISTORICAL_INGESTION",
10         "files": [
11           {
12             "source": "EXTERNAL",
13             "file_id": "V1StGXR8_Z5jdHi6B-myT",
14             "file_name": "Revolut IE (YTD) 2026.csv",
15             "file_size": 524288,
16             "mime_type": "text/csv",
17             "uploaded_at": "2026-01-15T09:30:00.000Z",
18             "uploaded_by": 8313893
19           }
20         ],
21         "status": "SUBMITTED",
22         "import_id": "2f8c9a41-6b3e-4d0a-9f21-77c1e0a5b3d8",
23         "created_at": "2026-01-15T09:30:00.000Z",
24         "updated_at": "2026-01-15T09:30:00.000Z",
25         "submitted_at": "2026-01-15T09:30:00.000Z",
26         "submitted_by": 8313893,
27         "legal_entity_id": "9a1f0e77-3c22-4b8d-8e64-2b0f5d9c1a44"
28       }
29     ]
30   },
31   "pagination": {
32     "limit": 20,
33     "has_more": false,
34     "next_cursor": "2f8c9a41-6b3e-4d0a-9f21-77c1e0a5b3d8"
35   }
36 }

List the payroll migration imports submitted for a legal entity, newest first, alongside the period the entity’s payroll data on the Deel side already covers. Paginated: while pagination.has_more is true, pass pagination.next_cursor back as cursor. Error codes: 400 BAD_REQUEST (unresolvable cursor), 401 UNAUTHORIZED, 403 FORBIDDEN, 403 PAYROLL_MIGRATION_IMPORT_DISABLED, 404 NOT_FOUND, 500 INTERNAL_SERVER_ERROR.

Token scopes: global-payroll:read

List the payroll migration imports submitted for a legal entity, newest first, alongside the period the entity's payroll data on the Deel side already covers. Paginated: while pagination.has_more is true, pass pagination.next_cursor back as cursor. Error codes: 400 BAD_REQUEST (unresolvable cursor), 401 UNAUTHORIZED, 403 FORBIDDEN, 403 PAYROLL_MIGRATION_IMPORT_DISABLED, 404 NOT_FOUND, 500 INTERNAL_SERVER_ERROR. **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.deel.training/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.deel.training/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

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'