---
title: "Find insights"
method: POST
path: "/v1/insights"
tags: ["Intelligence"]
---

# Find insights

`POST /v1/insights`

## Request

- Base URL: `https://api.onegoodarea.com`
- URL: `https://api.onegoodarea.com/v1/insights`
- Auth: HTTP bearer

Rank areas by anomaly (ABS peer-relative z-score) on a chosen signal.

## Request body

- object
  - `signal_key` string, required: Peer-relative-z derived signal key (e.g. 'crime.total_12m_peer_relative_z').
  - `country` 'England' | 'Wales' | 'Scotland'
  - `lad` string
  - `min_abs_z` number

## Response `200`

Default Response

- object
  - `signal_key` string, required
  - `insights` object[], required
    - `geo_code` string, required
    - `peer_relative_z` number, required
    - `abs_z` number, required
  - `meta` object, required
    - `generated_at` string, required
    - `scope` string, required
    - `threshold` number, required

## Other responses

- `400`: Default Response
- `404`: Default Response
- `422`: Default Response
- `500`: Default Response

---

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