---
title: "Page country-year organized-crime and firearms-tracing observations"
method: GET
path: "/atlas"
---

# Page country-year organized-crime and firearms-tracing observations

`GET /atlas`

## Request

- Base URL: `https://narcoscope.com/api/v1`
- URL: `https://narcoscope.com/api/v1/atlas`
- Auth: none declared

Returns the two source-native domains as separate records with their original metadata, per-record availability, caveats, and null-versus-zero distinction intact. The API never combines the domains into a shared score.

## Query parameters

- `domain` 'all' | 'firearms_tracing' | 'organized_crime'
- `iso3` string
- `year` integer
- `limit` integer
- `cursor` string

## Response `200`

Country-year illicit-economy atlas response

- AtlasRestEnvelope
  - `ok` unknown, required
  - `resource` 'atlas', required
  - `data` AtlasData, required
    - `schema` 'narcoscope.api.atlas.v1', required
    - `status` 'available' | 'partial' | 'unavailable', required
    - `query` object, required
      - `domain` 'all' | 'firearms_tracing' | 'organized_crime', required
      - `iso3` string, nullable, required
      - `year` integer, nullable, required
    - `sources` object[], required
      - `domain` 'firearms_tracing' | 'organized_crime', required
      - `status` 'available' | 'unavailable', required
      - `record_count` integer, nullable, required
      - `metadata` object, nullable, required
      - `error` object, nullable, required
    - `page` Pagination, required
      - `limit` integer, required
      - `matched` integer, required
      - `returned` integer, required
      - `has_more` boolean, required
      - `next_cursor` string, nullable, required
    - `records` object[], required
      - `domain` 'firearms_tracing' | 'organized_crime', required
      - `meta` object, required
      - `data` object, required
    - `limitations` string[], required

## Other responses

- `400`: Invalid resource parameters
- `503`: Typed unavailable evidence; absence is not zero coverage

---

[API](https://skmtc.dev/narcoscope/apis/narcoscope-public-evidence-api.md) · [All operations](https://skmtc.dev/narcoscope/apis/narcoscope-public-evidence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/narcoscope/apis/narcoscope-public-evidence-api/revisions/f70cc53e639d?raw)