Skip to main content
GET
/
contracts
/
{id}
Get contract
curl --request GET \
  --url https://api.tomorro.com/v2/contracts/{id} \
  --header 'x-api-key: <api-key>'
{
  "id": "ctr_550e8400-e29b-41d4-a716-446655440000",
  "name": "Service Agreement - Acme Corp",
  "status": "draft",
  "counterparty": {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "name": "Acme Corporation"
  },
  "contractType": {
    "id": "550e8400-e29b-41d4-a716-446655440002",
    "name": "Service Agreement"
  },
  "templateId": "550e8400-e29b-41d4-a716-446655440003",
  "author": {
    "id": "550e8400-e29b-41d4-a716-446655440004",
    "email": "john.doe@example.com"
  },
  "fields": [
    {
      "attributeDefinitionId": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Department",
      "value": "John Doe"
    }
  ],
  "signatories": [
    {
      "id": "sig_550e8400-e29b-41d4-a716-446655440005",
      "name": "John Doe",
      "email": "john.doe@example.com",
      "type": "member"
    }
  ],
  "integration": {
    "type": "salesforce",
    "externalId": "sf-123456",
    "externalEntity": "Opportunity",
    "externalUrl": "https://my-crm.example.com/opportunities/sf-123456"
  },
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-02-20T14:45:00.000Z",
  "contractMembers": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440004",
      "email": "john.doe@example.com"
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get your key at https://app.tomorro.com/settings/integrations?integration=api-key

Path Parameters

​
id
string
required

The unique identifier (UUID) of the contract

Example:

"550e8400-e29b-41d4-a716-446655440000"

Response

Contract

​
id
string
required

Unique identifier for the contract.

Example:

"ctr_550e8400-e29b-41d4-a716-446655440000"

​
name
string
required

The name or title of the contract.

Example:

"Service Agreement - Acme Corp"

​
status
string
required

The current status of the contract.

  • draft: The contract is being created or edited.
  • negotiating: The contract is being reviewed with counterparties.
  • signing: The contract is in the signature process.
  • signed: All parties have signed the contract.
  • canceled: The contract has been canceled.
Example:

"draft"

​
counterparty
object
required

The counterparty associated with this contract.

Example:
{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "name": "Acme Corporation"
}
​
contractType
object
required

The type of the contract, it is composed of many templates.

Example:
{
  "id": "550e8400-e29b-41d4-a716-446655440002",
  "name": "Service Agreement"
}
​
templateId
object
required

The template used to create this contract.

Example:

"550e8400-e29b-41d4-a716-446655440003"

​
author
object
required

The member who created this contract.

Example:
{
  "id": "550e8400-e29b-41d4-a716-446655440004",
  "email": "john.doe@example.com"
}
​
fields
object[]
required

The fields associated with this contract.

Example:
[
  {
    "attributeDefinitionId": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Department",
    "value": "John Doe"
  }
]
​
signatories
object[]
required

The signatories associated with this contract.

Example:
[
  {
    "id": "sig_550e8400-e29b-41d4-a716-446655440005",
    "name": "John Doe",
    "email": "john.doe@example.com",
    "type": "member"
  }
]
​
integration
object
required

The third-party system this contract is linked to, when it was created via an integration (currently Salesforce or HubSpot). The shape mirrors the integration payload accepted on POST /contracts, so you can use this to look up the originating record in your CRM. null when the contract has no external link or was created from the Tomorro web app.

Example:
{
  "type": "salesforce",
  "externalId": "sf-123456",
  "externalEntity": "Opportunity",
  "externalUrl": "https://my-crm.example.com/opportunities/sf-123456"
}
​
createdAt
string<date-time>
required

Time at which the contract was created. Formatted as an ISO 8601 date-time string.

Example:

"2024-01-15T10:30:00.000Z"

​
updatedAt
string<date-time>
required

Time at which the contract was last updated. Formatted as an ISO 8601 date-time string.

Example:

"2024-02-20T14:45:00.000Z"

​
contractMembers
object[]

The list of participants with this contract.

Example:
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440004",
    "email": "john.doe@example.com"
  }
]