---
title: "Do you come to this address?"
method: GET
path: "/v1/coverage"
tags: ["Services"]
---

# Do you come to this address?

`GET /v1/coverage`

## Request

- Base URL: `https://api.nogpets.com`
- URL: `https://api.nogpets.com/v1/coverage`
- Auth: none required

Places a typed address, a postal code or a map point in our territories and says which service lines reach it. When nothing does, `nearest` names our closest area.

## Query parameters

- `address` string
- `lat` number
- `lng` number
- `postalCode` string

## Response `200`

The answer (covered or not)

- Coverage
  - `covered` boolean, required
  - `error` 'NO_COVERAGE' | 'UNKNOWN_PLACE'
  - `leadId` string, nullable: NO_COVERAGE: the request is kept so our team can follow up.
  - `message` string: NO_COVERAGE: what to tell the person.
  - `next` string: NO_COVERAGE: what to do (say it plainly; promise nothing).
  - `place` Place
    - `suburb` string, nullable
    - `postalCode` string, nullable
    - `lat` number, nullable
    - `lng` number, nullable
    - `town` string, nullable: Abroad: the town it was found in.
    - `country` string: Abroad only: ISO 3166 code of the place's country.
  - `lines` LineCoverage[], required
    - `id` string, required
    - `label` string, required
    - `covered` boolean, required
  - `nearest` object, nullable
    - `name` string
    - `distanceKm` number

## Other responses

- `400`: The input is wrong (`INVALID_ARGUMENT`, or a pricing code such as `ONE_PRIMARY`, `PET_TYPE`, `UNKNOWN_SERVICE`).
- `429`: Too many requests (`RATE_LIMIT`). `Retry-After` says when to try again.

---

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