---
title: "Get a topic's raw ODCS data contract"
method: GET
path: "/api/v1/datasets/{main_topic}/{topic}/contract"
tags: ["meta"]
---

# Get a topic's raw ODCS data contract

`GET /api/v1/datasets/{main_topic}/{topic}/contract`

## Request

- Base URL: `https://georgiacivicdata.org`
- URL: `https://georgiacivicdata.org/api/v1/datasets/{main_topic}/{topic}/contract`
- Auth: none declared

Returns the authoritative ODCS v3.2 data contract for one topic so agents and clients can consume the machine-readable schema without cloning the repo. `?format=yaml` (default) returns the contract document verbatim; `?format=json` returns it parsed as JSON.

## Path parameters

- `main_topic` string, required
- `topic` string, required

## Query parameters

- `format` 'yaml' | 'json': Contract serialization: yaml | json

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/georgiacivicdata/apis/georgia-civic-data-api.md) · [All operations](https://skmtc.dev/georgiacivicdata/apis/georgia-civic-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/georgiacivicdata/apis/georgia-civic-data-api/revisions/dcfdf19662d2?raw)