---
title: "Discover granular drugs, arms and informal-economy evidence"
method: GET
path: "/markets"
---

# Discover granular drugs, arms and informal-economy evidence

`GET /markets`

## Request

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

Indicator-specific countries, categories, subgroups, native units, numeric and unavailable coverage, source hashes and source-specific reuse restrictions. Legacy atlas and drug histories remain linked but are not recounted.

## Response `200`

Source-bound published data. Partial coverage lists unavailable datasets explicitly.

- object
  - `ok` unknown, required
  - `resource` 'markets', required
  - `data` GlobalMarketCatalog, required
    - `schema` 'narcoscope.global-market-catalog.v1', required
    - `status` 'available' | 'partial' | 'unavailable', required
    - `generatedAt` string, date-time, nullable, required
    - `unavailableDatasets` string[], required
    - `limitations` string[], required
    - `datasets` object[], required
      - `id` 'global-drugs' | 'global-arms-economy', required
      - `title` string, required
      - `sha256` string, required
      - `generatedAt` string, date-time, required
      - `sources` object[], required
        - `id` string, required
        - `name` string, required
        - `publisher` string, required
        - `url` string, uri, required
        - `downloadUrl` string, uri, required
        - `license` string, required
        - `licenseUrl` string, uri, required
        - `retrievedAt` string, date-time, required
        - `sha256` string, required
        - `bytes` integer, required
        - `notes` string[], required
      - `indicators` object[], required
        - `id` string, required
        - `sourceId` string, required
        - `market` 'drugs' | 'arms' | 'economy', required
        - `label` string, required
        - `unit` string, required
        - `measureType` string, required
        - `description` string, required
        - `limitations` string[], required
        - `featured` boolean, required
        - `coverage` object, required
          - `observations` integer, required
          - `numericObservations` integer, required
          - `reported` integer, required
          - `estimated` integer, required
          - `unavailable` integer, required
          - `firstPeriod` string, nullable, required
          - `lastPeriod` string, nullable, required
          - `firstNumericPeriod` string, nullable, required
          - `lastNumericPeriod` string, nullable, required
        - `dimensions` object, required
          - `geographies` object[], required
            - `code` string, required
            - `name` string, required
            - `level` 'country' | 'region' | 'city' | 'world', required
          - `categories` string[], required
          - `subgroups` string[], required
          - `selections` object[], required
            - `category` string, required
            - `subgroup` string, required
            - `firstPeriod` string, nullable, required
            - `lastPeriod` string, nullable, required
            - `lastNumericPeriod` string, nullable, required
            - `latestNumericObservations` integer, required
      - `coverage` object, required
        - `observations` integer, required
        - `numericObservations` integer, required
        - `reported` integer, required
        - `estimated` integer, required
        - `unavailable` integer, required
        - `firstPeriod` string, nullable, required
        - `lastPeriod` string, nullable, required
        - `firstNumericPeriod` string, nullable, required
        - `lastNumericPeriod` string, nullable, required
      - `limitations` string[], required
    - `relatedResources` object[], required
      - `id` string, required
      - `title` string, required
      - `url` string, required
      - `description` 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)