---
title: "Query published regulatory relationship facts across packs"
method: POST
path: "/api/v1/regulatory-graph/query"
tags: ["Regulatory Graph API"]
---

# Query published regulatory relationship facts across packs

`POST /api/v1/regulatory-graph/query`

## Request

- Base URL: `https://api.esheria.ai`
- URL: `https://api.esheria.ai/api/v1/regulatory-graph/query`
- Auth: API key in header `x-api-key`

## Headers

- `idempotency-key` string, required

## Request body

- RegulatoryGraphQueryRequest
  - `pack_ids` string[], required
  - `relationship_types` string[]
  - `source_pack_id` string, nullable
  - `target_pack_id` string, nullable
  - `evidence_basis` string, nullable
  - `query` string, nullable
  - `publication_mode` 'published' | 'citation_verified' | 'blocked' | 'draft', nullable
  - `explain` boolean
  - `limit` integer
  - `offset` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: Unauthorized
- `402`: Credits exhausted
- `409`: Conflict
- `422`: Validation error
- `503`: Billing or dependency unavailable

---

[API](https://skmtc.dev/esheria/apis/esheria-regulatory-api.md) · [All operations](https://skmtc.dev/esheria/apis/esheria-regulatory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/esheria/apis/esheria-regulatory-api/revisions/33e5de529f65?raw)