Skip to main content
POST
/
api
/
v1
/
regulatory-graph
/
query
Query published regulatory relationship facts across packs
curl --request POST \
  --url https://reg-api.esheria.co.ke/api/v1/regulatory-graph/query \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "limit": 100,
  "pack_ids": [
    "KE-DATA-PROTECTION",
    "KE-CORPORATE-REGISTRY-BRS"
  ],
  "publication_mode": "published",
  "relationship_types": [
    "shares_evidence_with",
    "horizontal_obligation_for"
  ]
}
'
{
  "status": "error",
  "errors": [
    {
      "code": "unauthorized",
      "message": "Invalid API key"
    }
  ],
  "trace_id": "trace-123"
}

Documentation Index

Fetch the complete documentation index at: https://docs.esheria.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

x-api-key
string
header
default:YOUR_ESHERIA_API_KEY
required

Client API key issued by Esheria.

Headers

idempotency-key
string
required

Unique key for mutating request replay protection.

Body

application/json
pack_ids
string[]
relationship_types
string[]
source_pack_id
string | null
Maximum string length: 120
target_pack_id
string | null
Maximum string length: 120
evidence_basis
string | null
Maximum string length: 120
query
string | null
Maximum string length: 500
publication_mode
enum<string> | null
Available options:
published,
citation_verified,
blocked,
draft
limit
integer
default:100
Required range: 1 <= x <= 500
offset
integer
default:0
Required range: x >= 0

Response

Successful Response