Worked Examples

export N3_DATA_KEY="n3_data_xxxxxxxxxxxxxxxxxxxxxxxx"
export N3_DATA_URL="https://data.n-3.co.uk"

curl -s "${N3_DATA_URL}/data/quota" \
  -H "x-api-key: ${N3_DATA_KEY}" | jq

{
  "api_key_id": "0b2f6c1e-9a44-4c1d-8f3a-2f9d1c5e7a10",
  "environment_id": "42",
  "scopes": ["data:projects", "data:benchmarks", "data:reports"],
  "quota": {
    "used": 1240,
    "limit": 10000,
    "remaining": 8760,
    "resets_at": "2026-08-01T00:00:00.000Z",
    "period": "MONTH"
  },
  "throttle": { "rate_limit_per_second": 10, "burst_limit": 20 }
}

curl -s "${N3_DATA_URL}/data/projects?limit=25&offset=0&status=IN_PROGRESS" \
  -H "x-api-key: ${N3_DATA_KEY}" | jq

# Second page
curl -s "${N3_DATA_URL}/data/projects?limit=25&offset=25" \
  -H "x-api-key: ${N3_DATA_KEY}" | jq '.pagination'

{ "limit": 25, "offset": 25, "total": 173 }

curl -s "${N3_DATA_URL}/data/projects?limit=200" \
  -H "x-api-key: ${N3_DATA_KEY}" \
  | jq -r '.items[] | "\(.project_reference)\t\(.name)"'

curl -s "${N3_DATA_URL}/data/projects/1042" \
  -H "x-api-key: ${N3_DATA_KEY}" | jq

{
  "message": "Project not found",
  "error": "Not Found",
  "statusCode": 404
}

# Initial risk assessments (newest first)
curl -s "${N3_DATA_URL}/data/projects/1042/risk-assessments" \
  -H "x-api-key: ${N3_DATA_KEY}" | jq

# Development appraisal lines
curl -s "${N3_DATA_URL}/data/projects/1042/appraisals" \
  -H "x-api-key: ${N3_DATA_KEY}" | jq

curl -s "${N3_DATA_URL}/data/benchmarks?projectId=1042" \
  -H "x-api-key: ${N3_DATA_KEY}" | jq '.items[] | {id, type, model_value}'

# Metadata list
curl -s "${N3_DATA_URL}/data/reports?limit=10" \
  -H "x-api-key: ${N3_DATA_KEY}" | jq

# Detail with risk statuses
curl -s "${N3_DATA_URL}/data/reports/922" \
  -H "x-api-key: ${N3_DATA_KEY}" | jq '.risk_statuses'

curl -s "${N3_DATA_URL}/data/community/analytics" \
  -H "x-api-key: ${N3_DATA_KEY}" | jq

{
  "message": "This API key does not have the required scope(s): data:community",
  "error": "Forbidden",
  "statusCode": 403
}

curl -s -D - "${N3_DATA_URL}/data/projects?limit=1" \
  -H "x-api-key: ${N3_DATA_KEY}" -o /dev/null

HTTP/1.1 200 OK
X-RateLimit-Limit: 10
X-RateLimit-Remaining: 9
X-Quota-Limit: 10000
X-Quota-Remaining: 8759
X-Quota-Resets-At: 2026-08-01T00:00:00.000Z