List of something new new | Deel

{
  "data": [
    {
      "id": "a3f47b9e-8c2d-4f1a-9b7e-2d5f6a7c8e9b",
      "type": "ongoing_time_based",
      "title": "Monthly Maintenance Contract",
      "client": {
        "team": {
          "id": "team-987654321",
          "name": "Acme Corp Operations"
        }
      },
      "status": "new",
      "worker": {
        "id": "worker-123456789",
        "email": "jane.doe@example.com",
        "full_name": "Jane Doe",
        "image": "https://example.com/images/jane_doe.png",
        "alternate_email": [
          {
            "email": "jane.alt@example.com",
            "isVerified": true
          }
        ]
      },
      "created_at": "2024-01-15T09:30:00Z",
      "signatures": {
        "client_signed_at": "2024-01-15T10:00:00Z",
        "worker_signature": "SGVsbG8gV29ybGQ=",
        "worker_signed_at": "2024-01-15T10:05:00Z"
      },
      "invitations": {
        "client_email": "contracts@acmecorp.com",
        "worker_email": "jane.doe@example.com"
      },
      "is_archived": true,
      "is_shielded": true,
      "termination_date": "2024-12-31T23:59:59Z",
      "scale": "hourly",
      "external_id": "EXT-20240115-0001",
      "who_reports": "both",
      "notice_period": 30
    }
  ],
  "page": {
    "cursor": "eyJwYWdlIjoxfQ==",
    "total_rows": 25
  }
}

Retrieve a list of something.

Token scopes: contracts:read, contracts:write

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/

Query parameters

after_cursorstringOptional

Return next page of results after the given cursor.

limitstringOptionalformat: "^[0-9]+$"

Return a page of results with the given number of records.

order_directionenumOptional

Order direction of results; ascending or descending.

Allowed values:

typeslist of enumsOptional

Filter contracts by type. A contract is included in the results if its type is in this list.

statuseslist of enumsOptional

Filter contracts by current status. A contract is included in the results if its status is in this list.

team_idstringOptional

Filter contracts for the given team ID. NOTE: All query parameters are technically strings or arrays of strings.

external_idstringOptional

Filter contracts for the given external ID.

countrieslist of stringsOptional

Filter contracts by country codes.

currencieslist of strings or stringOptional

Filter something news by currency codes.

searchstringOptional

Include a something new if its name or the contractor's name contains the given search term.

sort_byenumOptional

Sort something new by the given field name.

Allowed values:

Response

Successful operation.

datalist of objects

pageobject

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'

$	curl https://api.letsdeel.com/rest/rest/somthing-ttt \
>	-H "Authorization: Bearer <token>"