How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Soda

Soda Contracts API

The Contracts surface of the Soda Cloud v4 API — 10 operation(s) across 8 path(s).

Documentation Provider Profile APIs.io OpenAPI GitHub

Soda Contracts API is one of 16 APIs that Soda publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Contracts. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 10 operations across 8 paths, and defines 19 schemas. It is described by OpenAPI 3.1.0, at version v1.

Requests are made against 2 base URLs: https://cloud.soda.io, https://cloud.us.soda.io.

10 operations 8 paths 19 schemas 5 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v1
Base URL
https://cloud.soda.io
Authentication
HTTP Basic, API Key
Contact
Soda
Resource Areas
1

Authentication & Security 2

Soda Contracts API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (basicAuthApiKey). An API key is passed in the cookie as token (cookieToken). By default, every request must be authenticated.

Paths & Operations 10

Across 8 paths, the API surfaces 10 operations — 5 GET, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Contracts 10

Soda Cloud API Contract Endpoints

GET
/api/v1/contracts
List contracts
GET/api/v1/contracts 4 params → 200400401403404429500
POST
/api/v1/contracts
Create a contract
POST/api/v1/contracts body → 200400401403404429500
POST
/api/v1/contracts/actions/createSkeleton
Generate skeleton contract
POST/api/v1/contracts/actions/createSkeleton body → 202400401403404429500
GET
/api/v1/contracts/actions/createSkeleton/{operationId}
Get skeleton contract generation status
GET/api/v1/contracts/actions/createSkeleton/{operationId} 1 param → 200400401403404429500
POST
/api/v1/contracts/actions/generate
Generate contracts
POST/api/v1/contracts/actions/generate body → 202400401403404429500
GET
/api/v1/contracts/actions/generate/{operationId}
Get contract generation status
GET/api/v1/contracts/actions/generate/{operationId} 1 param → 200400401403404429500
GET
/api/v1/contracts/{contractId}
Get a contract
GET/api/v1/contracts/{contractId} 1 param → 200400401403404429500
POST
/api/v1/contracts/{contractId}
Publish a contract
POST/api/v1/contracts/{contractId} 1 param body → 200400401403404429500
POST
/api/v1/contracts/{contractId}/verify
Verify a contract
POST/api/v1/contracts/{contractId}/verify 1 param body → 201400401403404429500
GET
/api/v1/contracts/{contractId}/versions
List contract versions
GET/api/v1/contracts/{contractId}/versions 4 params → 200400401403404429500

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are PublicApiListContractVersionsResponse (7 properties), PublicApiListContractsResponse (7 properties), ContractVersionDTO (6 properties), ContractContentDTO (6 properties). Each schema is shown below with its type and property counts.

ContractContentDTO
object
6 properties
ContractVersionDTO
object
6 properties
ErrorResponse
object
2 properties
GenerateContractOperationStateDTO
string
PublicApiCreateContractRequestDTO
object
3 properties 1 required
PublicApiCreateContractResponse
object
1 property
PublicApiCreateSkeletonContractRequestDTO
object
2 properties
PublicApiCreateSkeletonContractStatusResponse
object
5 properties
PublicApiGenerateContractRequestDTO
object
2 properties
PublicApiGenerateContractStatusResponse
object
4 properties
PublicApiGenerateContractStatusResponse_DatasetGenerationStatus
object
5 properties
PublicApiGetContractResponse
object
1 property
PublicApiListContractVersionsResponse
object
7 properties 7 required
PublicApiListContractsResponse
object
7 properties 7 required
PublicApiPublishContractRequestDTO
object
1 property 1 required
PublicApiPublishContractResponse
object
1 property
PublicApiVerifyContractRequestDTO
object
1 property
ScanStateDTO
string
SkeletonContractOperationStateDTO
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

soda-data-contracts-api-openapi.yml Raw ↑

Other APIs Soda publishes across the network.

Soda Cloud API v4
AE Profile APIs.io
Soda Attributes API
AE Profile APIs.io
Soda Checks API
AE Profile APIs.io
Soda Data Standards API
AE Profile APIs.io
Soda Datasets API
AE Profile APIs.io
Soda Datasources API
AE Profile APIs.io
Soda Discovered Datasets API
AE Profile APIs.io
Soda Incidents API
AE Profile APIs.io
Soda Licensing API
AE Profile APIs.io
Soda Notification Rules API
AE Profile APIs.io
Soda Runners API
AE Profile APIs.io
Soda Scans API
AE Profile APIs.io
#Contracts
← Back to S APIs
API Details
ID
soda-data:soda-data-contracts-api
Base URL
https://cloud.soda.io
Docs
https://docs.soda.io/reference/soda-apis/rest-api/contracts
Provider
Soda
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=soda-data-contracts-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/soda-data-contracts-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Soda Contracts API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.