Getting started

Authorization: Bearer dk_live_...

{
  "data": { "..." : "..." },
  "meta": {
    "request_id": "req_9u2h1k",
    "plan": "PRO"
  }
}

{
  "error": {
    "type": "rate_limited",
    "message": "Rate limit exceeded: 30 requests per minute on the FREE plan."
  }
}

curl https://api.dockase.com/v1/judgments/search \
  -H "Authorization: Bearer dk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "locus standi in election petitions",
    "limit": 5,
    "court_level": "SC",
    "year_from": 2015
  }'

{
  "data": [
    {
      "id": "jd_8f3k2m1x",
      "case_name": "Adeyemi v. INEC",
      "citation": "(2023) 12 AELR 45 (SC)",
      "court": "Supreme Court",
      "judgment_date": "2023-09-14",
      "ratio": "A petitioner who seeks to nullify an election must show that the alleged non-compliance substantially affected the result...",
      "summary": "The Supreme Court restated the test for locus standi in election petitions and held that...",
      "authority_score": 0.94,
      "confidence": 0.98,
      "snippet": "...the question of locus standi is a threshold issue that goes to the jurisdiction of the tribunal..."
    }
  ],
  "meta": {
    "request_id": "req_9u2h1k",
    "plan": "FREE"
  }
}

curl https://api.dockase.com/v1/judgments/jd_8f3k2m1x \
  -H "Authorization: Bearer dk_live_..."

curl https://api.dockase.com/v1/judgments/jd_8f3k2m1x/citations \
  -H "Authorization: Bearer dk_live_..."

{
  "data": {
    "id": "jd_8f3k2m1x",
    "cites": [
      {
        "id": "jd_2p9q4r7w",
        "case_name": "Okafor v. Attorney-General of Lagos State",
        "citation": "(2019) 4 AELR 112 (SC)",
        "treatment": "followed",
        "confidence": 0.97,
        "context_snippet": "...as this Court held in Okafor v. A-G Lagos State, the threshold question of standing must be resolved..."
      }
    ],
    "cited_by": [
      {
        "id": "jd_5t8y1u3i",
        "case_name": "Bello v. Zamfara State Electoral Commission",
        "citation": "(2025) 2 AELR 88 (CA)",
        "treatment": "distinguished",
        "confidence": 0.91,
        "context_snippet": "...the facts before us differ materially from Adeyemi v. INEC, and we accordingly distinguish..."
      }
    ]
  },
  "meta": {
    "request_id": "req_3f7j0a",
    "plan": "PRO"
  }
}

curl https://api.dockase.com/v1/citations/verify \
  -H "Authorization: Bearer dk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"citation": "(2023) 12 AELR 45 (SC)"}'

{
  "data": {
    "status": "VERIFIED",
    "matched": {
      "id": "jd_8f3k2m1x",
      "case_name": "Adeyemi v. INEC",
      "citation": "(2023) 12 AELR 45 (SC)",
      "court": "Supreme Court",
      "judgment_date": "2023-09-14"
    }
  },
  "meta": {
    "request_id": "req_6m1z8q",
    "plan": "PRO"
  }
}

curl "https://api.dockase.com/v1/statutes?category=electoral&jurisdiction=federal" \
  -H "Authorization: Bearer dk_live_..."

{
  "data": [
    {
      "id": "st_electoral_act_2022",
      "title": "Electoral Act, 2022",
      "category": "electoral",
      "jurisdiction": "federal",
      "year": 2022,
      "updated_at": "2026-08-30"
    }
  ],
  "meta": {
    "request_id": "req_1x4v7n",
    "plan": "FREE"
  }
}

curl https://api.dockase.com/v1/statutes/st_electoral_act_2022 \
  -H "Authorization: Bearer dk_live_..."

{
  "data": {
    "id": "st_electoral_act_2022",
    "title": "Electoral Act, 2022",
    "category": "electoral",
    "jurisdiction": "federal",
    "year": 2022,
    "updated_at": "2026-08-30",
    "body_markdown": "# Electoral Act, 2022\n\n## Part I – Establishment and Functions of INEC\n\n**1.** (1) The Independent National Electoral Commission..."
  },
  "meta": {
    "request_id": "req_8b2c5d",
    "plan": "FREE"
  }
}

curl https://api.dockase.com/v1/embeddings \
  -H "Authorization: Bearer dk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "amicus-embed-ng-v1",
    "input": "The ratio decidendi of the judgment concerns locus standi..."
  }'

{
  "data": {
    "object": "list",
    "data": [
      {
        "object": "embedding",
        "index": 0,
        "embedding": [0.0124, -0.0871, 0.0442, "..."]
      }
    ],
    "model": "amicus-embed-ng-v1",
    "usage": {
      "prompt_tokens": 14,
      "total_tokens": 14
    }
  },
  "meta": {
    "request_id": "req_5k9p2t",
    "plan": "PRO"
  }
}