Contracts API - HubSpot docs

Required Scopes

Contracts represent the committed revenue agreements between buyers and sellers, detailing products, billing, and payment terms. Use the contracts API to create, retrieve contract CRM records in HubSpot. For more information on using contracts in HubSpot, see create and manage contracts.

To manage contract terms, line items, billing, and mid-contract changes programmatically, use the commerce contracts API.

Retrieve contracts

You can retrieve all contracts or individual contracts by ID.

To retrieve all contracts, make a GET request to /crm/objects/2026-09/contracts.
To retrieve a specific contract, make a GET request to /crm/objects/2026-09/contracts/{contractId}.

The response includes a few default properties, including the create date and last modified date. To return additional properties, specify them by name using the ?properties= query parameter. For example, to retrieve contracts with their name and effective date:

GET /crm/objects/2026-09/contracts?properties=hs_name,hs_contract_effective_date

{
  "results": [
    {
      "id": "398334119041",
      "properties": {
        "hs_contract_effective_date": "2026-09-01",
        "hs_createdate": "2026-08-15T11:32:10.699Z",
        "hs_lastmodifieddate": "2026-08-15T11:32:12.651Z",
        "hs_name": "Enterprise Platform License 2026",
        "hs_object_id": "398334119041"
      },
      "createdAt": "2026-08-15T11:32:10.699Z",
      "updatedAt": "2026-08-15T11:32:12.651Z",
      "archived": false
    }
  ]
}

Batch read

To retrieve multiple contracts in a single request, make a POST request to /crm/objects/2026-09/contracts/batch/read. Include an inputs array of record IDs and an optional properties array to specify which properties to return.

{
  "inputs": [
    { "id": "398334119041" },
    { "id": "399027563070" }
  ],
  "properties": ["hs_name", "hs_contract_effective_date"]
}

​Retrieve contracts

​Batch read

Retrieve contracts

Batch read