Payments

Get a payment challenge

Changed on Oct 5, 2026

Fetch a challenge you created, to poll its status and settlement receipt (settle_tx). Scoped to the challenger org that created it.

get/x402/challenges/{id}

Request

Base URL: https://api.primitive.dev/v1
URL: https://api.primitive.dev/v1/x402/challenges/{id}
Auth: HTTP bearer

Path parameters

idstring uuid required

Resource UUID

Response

The challenge

successboolean required

Example response

{
  "data": {
    "payment_requirements": {
      "scheme": "exact"
    }
  }
}

Changes

Oct 5, 202652138fa51360 Revision changes
- info
  removed the invalid_signup_code enum value from the / response property for the response status
- info
  removed the invalid_signup_code enum value from the / response property for the response status
- info
  removed the invalid_signup_code enum value from the / response property for the response status
- info
  removed the invalid_signup_code enum value from the / response property for the response status
- info
  removed the invalid_signup_code enum value from the / response property for the response status
Oct 2, 202622d1dfc68434 Revision changes
- warning
  added the new not_a_repeating_send enum value to the / response property for the response status
- warning
  added the new not_a_repeating_send enum value to the / response property for the response status
- warning
  added the new not_a_repeating_send enum value to the / response property for the response status
- warning
  added the new not_a_repeating_send enum value to the / response property for the response status
- warning
  added the new not_a_repeating_send enum value to the / response property for the response status
- warning
  added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status
- warning
  added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status
- warning
  added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status
- warning
  added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status
- warning
  added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status
- warning
  added the new repeat_recipient_external enum value to the / response property for the response status
- warning
  added the new repeat_recipient_external enum value to the / response property for the response status
- warning
  added the new repeat_recipient_external enum value to the / response property for the response status
- warning
  added the new repeat_recipient_external enum value to the / response property for the response status
- warning
  added the new repeat_recipient_external enum value to the / response property for the response status
- warning
  added the new repeat_stop_not_allowed enum value to the / response property for the response status
- warning
  added the new repeat_stop_not_allowed enum value to the / response property for the response status
- warning
  added the new repeat_stop_not_allowed enum value to the / response property for the response status
- warning
  added the new repeat_stop_not_allowed enum value to the / response property for the response status
- warning
  added the new repeat_stop_not_allowed enum value to the / response property for the response status
- warning
  added the new repeat_unsupported enum value to the / response property for the response status
- warning
  added the new repeat_unsupported enum value to the / response property for the response status
- warning
  added the new repeat_unsupported enum value to the / response property for the response status
- warning
  added the new repeat_unsupported enum value to the / response property for the response status
- warning
  added the new repeat_unsupported enum value to the / response property for the response status

Operation history (11 revisions)