---
title: "Poll an agent signup request"
method: POST
path: "/api/agent_signup_status"
tags: ["Agent signup"]
---

# Poll an agent signup request

`POST /api/agent_signup_status`

## Request

- Base URL: `https://app.pedra.ai`
- URL: `https://app.pedra.ai/api/agent_signup_status`
- Auth: none required

No apiKey needed. Returns `pending` (poll again in 5 s), `approved` (with the apiKey — retrievable for 15 minutes after approval; the key itself doesn't expire), `denied` or `expired`. New accounts start with Pedra's free trial credits. When `creditsRemaining` is 0, `note` says the person can get credits with a plan.

## Request body

- object
  - `requestId` string, required: From /api/agent_signup.

## Response `200`

Current status of the request.

- object
  - `status` 'pending' | 'approved' | 'denied' | 'expired', required
  - `pollAfterSeconds` integer: With pending.
  - `apiKey` string: With approved.
  - `email` string
  - `newAccount` boolean: True when the account was created by this request.
  - `plan` string
  - `creditsRemaining` number
  - `appUrl` string
  - `note` string: Present when creditsRemaining is 0: how the person unlocks credits.

## Other responses

- `404`: Unknown requestId.
- `405`: Wrong HTTP method.

---

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