> ## Documentation Index > Fetch the complete documentation index at: https://alpha.developer.tomorro.com/llms.txt > Use this file to discover all available pages before exploring further. # Get contract > Get a contract ## OpenAPI ````yaml /openapi-2025-01-29.alpha.json get /contracts/{id} openapi: 3.0.0 info: title: Tomorro API description: > The Tomorro Public API enables you to programmatically manage contracts, members, and counterparties. Build powerful integrations that automate your contract management workflows. ## API Version: 2025-01-29.alpha This documentation is for API version `2025-01-29.alpha`. ### Using this version ``` curl -X GET https://api.tomorro.com/members \ -H "x-api-key: YOUR_API_KEY" \ -H "tomorro-version: 2025-01-29.alpha" ``` version: 2025-01-29.alpha contact: {} servers: - url: https://api.tomorro.com/v2 description: Production - url: https://api.demo.tomorro.com/v2 description: Demo - url: http://localhost:3015 description: Local Development security: [] tags: [] paths: /contracts/{id}: get: tags: - Contracts summary: Get contract description: Get a contract operationId: ContractController_getContract parameters: - name: id required: true in: path description: The unique identifier (UUID) of the contract schema: example: 550e8400-e29b-41d4-a716-446655440000 type: string responses: '200': description: Contract content: application/json: schema: $ref: '#/components/schemas/ContractResponseDto' '401': description: Unauthorized - Invalid or missing API key '403': description: Forbidden - Insufficient permissions '429': description: Too Many Requests - Rate limit exceeded security: - X-API-KEY: [] components: schemas: ContractResponseDto: type: object properties: id: type: string description: Unique identifier for the contract. example: ctr_550e8400-e29b-41d4-a716-446655440000 name: type: string description: The name or title of the contract. example: Service Agreement - Acme Corp status: type: string description: |- 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: description: The counterparty associated with this contract. nullable: true example: id: 550e8400-e29b-41d4-a716-446655440001 name: Acme Corporation type: object allOf: - $ref: '#/components/schemas/ContractCounterpartyDto' contractType: description: The type of the contract, it is composed of many templates. nullable: true example: id: 550e8400-e29b-41d4-a716-446655440002 name: Service Agreement type: object allOf: - $ref: '#/components/schemas/ContractTypeDto' templateId: type: string description: The template used to create this contract. nullable: true example: 550e8400-e29b-41d4-a716-446655440003 author: description: The member who created this contract. example: id: 550e8400-e29b-41d4-a716-446655440004 email: john.doe@example.com allOf: - $ref: '#/components/schemas/ContractMemberDto' fields: description: The fields associated with this contract. example: - attributeDefinitionId: 123e4567-e89b-12d3-a456-426614174000 name: Department value: John Doe type: array items: $ref: '#/components/schemas/ContractFieldsDto' signatories: description: The signatories associated with this contract. example: - id: sig_550e8400-e29b-41d4-a716-446655440005 name: John Doe email: john.doe@example.com type: member type: array items: $ref: '#/components/schemas/ContractSignatoryDto' integration: description: >- 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. nullable: true example: type: salesforce externalId: sf-123456 externalEntity: Opportunity externalUrl: https://my-crm.example.com/opportunities/sf-123456 type: object allOf: - $ref: '#/components/schemas/ContractIntegrationDto' contractMembers: description: The list of participants with this contract. example: - id: 550e8400-e29b-41d4-a716-446655440004 email: john.doe@example.com type: array items: $ref: '#/components/schemas/ContractMemberDto' createdAt: format: date-time type: string description: >- Time at which the contract was created. Formatted as an ISO 8601 date-time string. example: '2024-01-15T10:30:00.000Z' updatedAt: format: date-time type: string description: >- Time at which the contract was last updated. Formatted as an ISO 8601 date-time string. example: '2024-02-20T14:45:00.000Z' required: - id - name - status - counterparty - contractType - templateId - author - fields - signatories - integration - createdAt - updatedAt ContractCounterpartyDto: type: object properties: id: type: string description: Unique identifier for the counterparty. example: cp_550e8400-e29b-41d4-a716-446655440001 name: type: string description: The display name of the counterparty (company or individual name). example: Acme Corporation required: - id - name ContractTypeDto: type: object properties: id: type: string description: Unique identifier for the contract type. example: type_550e8400-e29b-41d4-a716-446655440002 name: type: string description: The name of the contract type. example: Service Agreement nullable: true required: - id - name ContractMemberDto: type: object properties: id: type: string description: Unique identifier for the member. example: mem_550e8400-e29b-41d4-a716-446655440004 email: type: string description: The email address of the member. example: john.doe@example.com required: - id - email ContractFieldsDto: type: object properties: attributeDefinitionId: type: string description: Unique identifier for the attribute definition. example: 123e4567-e89b-12d3-a456-426614174000 name: type: string description: The display name of the attribute definition. example: Department value: type: string description: The value of the attribute. example: Marketing nullable: true required: - attributeDefinitionId - name - value ContractSignatoryDto: type: object properties: id: type: string description: Unique identifier for the signatory. example: sig_550e8400-e29b-41d4-a716-446655440005 name: type: string description: The name of the signatory. example: John Doe email: type: string description: The email address of the signatory. example: john.doe@example.com type: type: string description: The type of the signatory. enum: - member - guest - external example: member required: - id - name - email - type ContractIntegrationDto: type: object properties: type: type: string description: >- The third-party system the contract is linked to. Currently one of `salesforce` or `hubspot`; new values may be added as Tomorro ships support for additional integrations. enum: - salesforce - hubspot example: salesforce externalId: type: string description: >- External identifier of the linked record in the third-party system (e.g. the Salesforce Opportunity ID). example: sf-123456 externalEntity: type: string description: >- External entity type the contract is linked to (e.g. `Opportunity` for Salesforce, `Deal` for HubSpot). nullable: true example: Opportunity externalUrl: type: string description: >- Deep link to the linked record in the third-party system, when one is available. nullable: true example: https://my-crm.example.com/opportunities/sf-123456 required: - type - externalId - externalEntity - externalUrl securitySchemes: X-API-KEY: type: apiKey in: header name: x-api-key description: >- API key for authentication. Get your key at https://app.tomorro.com/settings/integrations?integration=api-key ````