Retrieve Milestones by Contract | Deel

Retrieve a list of milestones associated with a specific contract. Each milestone includes details such as its title, amount, status, and relevant dates, along with information about the creator and reviewer. Token scopes: milestones: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/

Path parameters

contract_idstringRequired

The unique identifier of the Deel contract for which milestones are being retrieved.

Response

A list of milestones for the specified contract.

datalist of objects

An array of milestone objects associated with the contract.

1	{
2	"data": [
3	{
4	"id": "00000000-0000-0000-0000-000000000000",
5	"title": "Initial Design Phase",
6	"amount": "5000.00",
7	"status": "Pending Approval",
8	"created_at": "2024-11-26T15:30:00Z",
9	"description": "Design the initial prototype of the application.",
10	"reported_by": {
11	"id": "00000000-0000-0000-0000-000000000000",
12	"full_name": "Jane Smith"
13	},
14	"reviewed_by": {
15	"id": "00000000-0000-0000-0000-000000000000",
16	"full_name": "John Doe"
17	},
18	"approval_requested": true
19	}
20	]
21	}

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

1	curl https://api.letsdeel.com/rest/v2/contracts/37nex2x/milestones \
2	-H "Authorization: Bearer <token>"

Authentication

Authentication

Path parameters

Response

Errors

Authentication