---
title: "Poll whether an authentication request was confirmed"
method: POST
path: "/auth/poll"
tags: ["auth"]
---

# Poll whether an authentication request was confirmed

`POST /auth/poll`

Using the token acquired in the `start` endpoint, you can start polling this endpoint once every 10 seconds.

When the user has confirmed the authentication request on their end, this endpoint will return the user's API key that you can use in subsequent authenticated endpoints. Note that it'll do so only once, subsequent requests after the initial 200 response will return a 404.

For as long as the user did not yet confirm their authentication request, this endpoint will return a 403.

## Request body

- object
  - `token` string

## Response `200`

The user confirmed the authentication request

- object
  - `apikey` string — The user's API key
  - `username` string — The user's username

## Other responses

- `403` — The authentication request was not confirmed yet
- `404` — The authentication request was not found
- `429` — You are polling too quickly, please back off

---

[API](https://skmtc.net/tvmaze/apis/tvmaze-user-api.md) · [All operations](https://skmtc.net/tvmaze/apis/tvmaze-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tvmaze/tvmaze-user-api/revisions/4a251a7b3226/schema)