Retrieve payment receipts | Deel

Retrieve a list of payments made to Deel, including worker details, payment status, and payment methods. Token scopes: accounting: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.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -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/

Query parameters

date_fromstringOptionalformat: "date"

Filters results to include payments created on or after this date (in ISO 8601 format).

date_tostringOptionalformat: "date"

Filters results to include payments created before this date (in ISO 8601 format).

cursorstringOptional

A cursor for pagination. Use the value returned in the ‘next_cursor’ field to get the next page of results.

currencieslist of strings or stringOptional

Filters payments by their currency codes. Can be a single currency code or an array of codes.

entitieslist of enums or enumOptional

Filters payments by legal entity type (e.g., ‘individual’ or ‘company’). Can be a single entity type or an array.

statuseslist of enums or enumOptional

Filters payments by their status (e.g., ‘paid’ or ‘processing’). Can be a single status type or an array.

Response

Successful operation.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

1	import requests
2
3	url = "https://api.letsdeel.com/rest/v2/payments"
4
5	querystring = {"date_from":"2022-01-01","date_to":"2022-12-31","cursor":"BHF2gkMEMT8D9UQDmty66","currencies":"[\"USD\",\"EUR\"]","entities":"[\"company\"]","statuses":"[\"paid\",\"processing\"]"}
6
7	headers = {"Authorization": "Bearer <token>"}
8
9	response = requests.get(url, headers=headers, params=querystring)
10
11	print(response.json())

1	{
2	"data": {
3	"rows": [
4	{
5	"id": "34d7Y48Ymu44g66fghN9F",
6	"label": "REC-2024-3",
7	"status": "paid",
8	"paid_at": "2022-05-24T09:38:46.235Z",
9	"workers": [
10	{
11	"picUrl": "https://cdn.deel.com/avatars/user-123.jpg",
12	"id": "f2f31dd9-06d7-4944-89bd-449b0fd54855",
13	"name": "Jane Doe",
14	"contract_id": "37nex2x"
15	}
16	],
17	"invoices": [
18	{
19	"id": "invoice-001"
20	}
21	],
22	"timezone": "+02:00",
23	"created_at": "2022-05-23T14:45:30.123Z",
24	"deel_reference": "DEEL72T6KJ",
25	"payment_method": {
26	"type": "ach"
27	},
28	"payment_currency": "GBP"
29	}
30	],
31	"total": 150,
32	"has_more": "true",
33	"next_cursor": "BHF2gkMEMT8D9UQDmty66",
34	"total_count": 150
35	}
36	}

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