Skip to main content

​
Overview

The Cortado API is a small, read-only HTTP JSON API. It lets your own tools look up leads and contacts belonging to your organization.
The API is in beta and is enabled per organization. Turn it on from Settings > Integrations > API Keys, or email support@cortado.pro to request access. See the API Keys guide for the setup walkthrough.

​
Base URL

Every endpoint is served over HTTPS and returns JSON.

​
Quick Start

​
What You Can Do

Authentication

Sending your API key and what the limits are

Errors

Status codes and the error envelope

Get a Lead

GET /leads/{id}

Get a Contact

GET /contacts/{id}

​
Conventions

  • Read-only. There are no create, update, or delete endpoints. A key can never change your data.
  • Scoped to one organization. A key reads only the organization it was created in.
  • Timestamps are RFC 3339 in UTC — for example 2026-10-05T18:30:00Z.
  • Optional fields are always present, with null when there is no value. A field is omitted only where noted.
  • IDs are UUIDs. You can copy a record’s ID from its URL in Cortado.

​
Stability

Response shapes are defined separately from Cortado’s internal data model, so day-to-day product changes don’t alter what your integration receives. New fields may be added over time — write your integration so unknown fields are ignored rather than treated as errors.