---
title: "Public number lookup"
method: GET
path: "/v1/public/numbers/{e164}"
tags: ["Owner"]
---

# Public number lookup

`GET /v1/public/numbers/{e164}`

## Request

- Base URL: `https://api.vicem.ai`
- URL: `https://api.vicem.ai/v1/public/numbers/{e164}`
- Auth: none required

## Path parameters

- `e164` string, required

## Response `200`

OK

- PublicNumberLookupResponse
  - `report` object, nullable, required
    - `e164` string, required
    - `reports` integer, required
    - `robocall` integer, required
    - `firstDay` string, required
    - `lastDay` string, required
    - `months` object[], required
      - `month` string, required
      - `reports` integer, required
    - `subjects` object[], required
      - `subject` string, required
      - `reports` integer, required
    - `states` object[], required
      - `state` string, required
      - `reports` integer, required
    - `counted` integer, required
  - `related` object[], required
    - `e164` string, required
    - `reports` integer, required
  - `dataThrough` string, nullable, required
  - `released` boolean

## Other responses

- `404`: No such resource, or not visible to this caller.
- `429`: Too many requests from this caller; wait and try again.
- `500`: Unexpected server error (reported to Sentry).

---

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