---
title: "Create a website verification"
method: POST
path: "/v2/website-verifications"
tags: ["Website verifications (Coming soon)"]
---

# Create a website verification

`POST /v2/website-verifications`

## Request

- Base URL: `https://api.ubble.ai`
- URL: `https://api.ubble.ai/v2/website-verifications`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ubble/apis/checkout-com-identity-verification/docs/v2/website-verifications/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a website verification

## Request body

- WebsiteVerificationInputPost
  - `user_journey_id` string: User journey unique identifier.
  - `applicant_id` string: Business Applicant unique identifier.
  - `webhook_url` string, uri
  - `website_url` string, uri: URL of the website to be verified

## Response `201`

Website verification created successfully

- WebsiteVerificationOutputPost
  - `id` string: Website verification unique identifier.
  - `status` 'initial_status' | 'created' | 'checks_in_progress' | 'approved' | 'declined' | 'inconclusive': Status of the website verification.
  - `response_codes` ResponseCodes[]
    - `code` integer, required: The numeric code of the response code.
    - `summary` string, required: A descriptive code of the response code.
  - `risk_labels` RiskLabel[]: Risk assessment labels
  - `website_data` WebsiteVerificationResult
    - `legal_name` string: Legal name of the company
    - `country_of_incorporation` string, ISO 3166-1 alpha-2
    - `mccs` string[]: MCCs of the company
    - `alternative_mccs` string[]: Alternative MCCs of the company
    - `mcc_rationale` string: Rationale for the MCCs
    - `risky_activities` string[]: Risky activities of the company
    - `legal_address` Address
      - `address_line1` string
      - `address_line2` string
      - `city` string
      - `state` string
      - `zip` string
      - `country` string, ISO 3166-1 alpha-2
    - `disclosure_urls` DisclosureURLs: URLs to disclosure pages found on the website
      - `privacy_policy_url` string, uri, nullable: URL to the privacy policy page
      - `terms_and_conditions_url` string, uri, nullable: URL to the terms and conditions page
      - `refund_policy_url` string, uri, nullable: URL to the refund policy page
      - `contact_us_url` string, uri, nullable: URL to the contact us page
    - `registration_date` string, date, nullable: The registration date of the domain
  - `_links` WebsiteVerificationLinks
    - `self` HalLink, required
      - `href` string, uri, required
    - `applicant` HalLink, required
      - `href` string, uri, required
  - `user_journey_id` string: User journey unique identifier.
  - `applicant_id` string: Business Applicant unique identifier.
  - `webhook_url` string, uri
  - `website_url` string, uri: URL of the website to be verified
  - `created_on` string, date-time, required: UTC Date time when the resource was created
  - `modified_on` string, date-time, required: UTC Date time when the resource was modified

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `422`: Unprocessable entity
- `500`: Internal server error
- `503`: Service unavailable

---

[API](https://skmtc.dev/ubble/apis/checkout-com-identity-verification.md) - [All operations](https://skmtc.dev/ubble/apis/checkout-com-identity-verification/llms.txt) - [OpenAPI document](https://skmtc.dev/ubble/apis/checkout-com-identity-verification/revisions/739e9da12584?raw)