> ## Documentation Index > Fetch the complete documentation index at: https://developer.hellgate.io/llms.txt > Use this file to discover all available pages before exploring further. # Verify a domain > Re-verify a `pending` or `failed` domain, for example a row created before a mode switch or a failed `sf_operated` attempt. A domain that is already `verified` returns `409` with the classifier `DOMAIN_NOT_RETRIABLE`. On `self_managed` instances the domain is marked `verified` immediately, trusting your own attestation of domain ownership to Apple. On `sf_operated` instances Guardian schedules a background verification against Apple's Web Merchant Registration API using the platform integrator identity; if the attempt cannot be scheduled, the request returns `503` with the classifier `ENQUEUE_FAILED`. ## OpenAPI ````yaml /products/guardian/openapi.yaml post /api/wallet/apple-pay/domains/{id}/verify openapi: 3.1.0 info: title: Guardian API version: '1.0' contact: name: Starfish GmbH & Co. KG email: hello@starfish.team url: https://hellgate.io/cpa/guardian license: name: Hellgate API Terms url: https://hellgate.io/terms-and-conditions servers: - url: https://{cluster_id}.on-hellgate.cloud description: Guardian service instance variables: cluster_id: default: my-cluster-id description: | Guardian is a service of the Hellgate Cloud Platform. The unique cluster-id is used to connect to your instance. security: [] tags: - name: pci description: Management of card payment credentials under the ruling of PCI DSS. - name: network description: Management of network tokens and cryptograms for secure transactions. - name: generic description: Management of generic tokens and their schemas for various use cases. - name: metadata description: Inquiries for card metadata based on PAN, PCI tokens, or network tokens. - name: wallet description: >- Management of wallet tokens ingested from device wallets such as Google Pay. - name: apikey description: Management of API keys for service access. - name: webhook description: Management of webhooks for event notifications. - name: types description: Management of types for generic token schemas. paths: /api/wallet/apple-pay/domains/{id}/verify: post: tags: - wallet summary: Verify a domain description: > Re-verify a `pending` or `failed` domain, for example a row created before a mode switch or a failed `sf_operated` attempt. A domain that is already `verified` returns `409` with the classifier `DOMAIN_NOT_RETRIABLE`. On `self_managed` instances the domain is marked `verified` immediately, trusting your own attestation of domain ownership to Apple. On `sf_operated` instances Guardian schedules a background verification against Apple's Web Merchant Registration API using the platform integrator identity; if the attempt cannot be scheduled, the request returns `503` with the classifier `ENQUEUE_FAILED`. operationId: wallet_apple_pay_domain_verify parameters: - in: path name: id description: The ID of the domain to verify. required: true schema: type: string format: uuid responses: '200': description: Success response content: application/json: schema: $ref: '#/components/schemas/apple_pay_domain' '400': $ref: '#/components/responses/400_BadRequestError' '401': $ref: '#/components/responses/401_UnauthorizedError' '403': $ref: '#/components/responses/403_ForbiddenError' '404': $ref: '#/components/responses/404_NotFoundError' '409': $ref: '#/components/responses/409_ConflictError' '422': $ref: '#/components/responses/422_ValidationError' '503': $ref: '#/components/responses/503_ServiceUnavailableError' security: - APIKey: [] - AdminToken: [] components: schemas: apple_pay_domain: title: Apple Pay Domain type: object properties: id: type: string format: uuid domain: type: string example: pay.example.com state: type: string example: verified enum: - pending - verified - failed last_verified_at: type: string format: date-time nullable: true created_at: type: string format: date-time required: - id - domain - state - created_at ErrorGeneric: type: object properties: code: $ref: '#/components/schemas/ErrorStatusCode' classifier: $ref: '#/components/schemas/ErrorClassifier' message: $ref: '#/components/schemas/ErrorMessage' ErrorValidation: type: object properties: code: $ref: '#/components/schemas/ErrorStatusCode' classifier: $ref: '#/components/schemas/ErrorClassifier' message: $ref: '#/components/schemas/ErrorMessage' validation_errors: type: array items: type: object properties: path: type: string description: Json-path in the request which points to the validation error message: type: string description: Human readable validation message ErrorStatusCode: type: integer description: The corresponding HTTP status code for the error ErrorClassifier: type: string description: Technical code that helps to identify the error ErrorMessage: type: string description: Human readable representation of the error responses: 400_BadRequestError: description: Error response content: application/json: schema: $ref: '#/components/schemas/ErrorGeneric' example: code: 400 message: The request could not be handle due to invalid data classifier: BAD_REQUEST 401_UnauthorizedError: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorGeneric' example: code: 401 message: No valid means of authentication was provided classifier: UNAUTHORIZED 403_ForbiddenError: description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorGeneric' example: code: 403 message: Not allowed to access this resource or feature classifier: FORBIDDEN 404_NotFoundError: description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorGeneric' example: code: 404 message: The requested resource was not found. classifier: NOT_FOUND 409_ConflictError: description: Conflict content: application/json: schema: $ref: '#/components/schemas/ErrorGeneric' example: code: 409 message: Conflict classifier: CONFLICT 422_ValidationError: description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorValidation' example: code: 422 classifier: VALIDATION_ERROR message: Validation error validation_errors: - path: json-path message: human readable error message 503_ServiceUnavailableError: description: The server is currently not able to handle the request content: application/json: schema: $ref: '#/components/schemas/ErrorGeneric' example: code: 503 message: Service unavailable classifier: SERVICE_UNAVAILABLE securitySchemes: APIKey: type: apiKey name: x-api-key in: header AdminToken: type: apiKey name: x-admin-token in: header ````