---
title: "Get the state of a register-signer job"
method: GET
path: "/v1/agent-wallets/register-signer/{jobId}"
tags: ["Agent Wallet Signers"]
---

# Get the state of a register-signer job

`GET /v1/agent-wallets/register-signer/{jobId}`

## Request

- Base URL: `https://api.prod.keyban.io`
- URL: `https://api.prod.keyban.io/v1/agent-wallets/register-signer/{jobId}`
- Auth: one of:
  - API key in header `X-Api-Key`
  - `bearer` (a scheme the document does not define)

Polled by the agent to follow up on the registration. Returns the BullMQ job state mapped to a domain state (pending/broadcasting/confirmed/failed/unknown). `pending` also covers the wait between two attempts; `failed` is final. On `confirmed`, includes the on-chain transaction hash, empty when another job registered the signer. On `failed`, includes the error message.

## Path parameters

- `jobId` string, required

## Response `200`

Current job state.

- object
  - `state` 'pending' | 'broadcasting' | 'confirmed' | 'failed' | 'unknown'
  - `txHash` string, nullable
  - `error` string, nullable

---

[API](https://skmtc.dev/keyban/apis/keyban-rest-apis.md) · [All operations](https://skmtc.dev/keyban/apis/keyban-rest-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/keyban/apis/keyban-rest-apis/revisions/0bb79a1da961?raw)