BixelDocs
API reference

Check a claim's proof now

POST
/v1/claims/{id}/verify

Look for the method's proof (the TXT record, the meta tag, or the verified e-mail domain) and, when present, attach the claim to the brand the domain resolves to. Verified claims are immutable. A domain that does not resolve to a covered brand cannot be claimed yet (422 claim_domain_not_covered); a missing proof answers 422 claim_verification_failed with what was checked. Idempotent on a verified claim. Costs 0 credits.

Authorization

AuthorizationBearer <token>

bx_-prefixed API key. Free keys: https://bixel.com/account/

In: header

Path Parameters

id*string

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/claims/string/verify"
{  "data": {    "claim": {      "id": "string",      "domain": "string",      "method": "dns_txt",      "status": "pending",      "bixel_id": "string",      "requested_at": "2019-08-24T14:15:22Z",      "verified_at": "2019-08-24T14:15:22Z",      "instructions": "string"    }  },  "meta": {    "generated_at": "2019-08-24T14:15:22Z",    "count": 0,    "total": 0,    "next_cursor": "string",    "notice": "string",    "window": {      "served_from": "string",      "earliest_event_at": "string",      "events_beyond_window": true    },    "data_version": "string",    "resolved_at": "2019-08-24T14:15:22Z",    "attribution": {      "source": "Bixel",      "url": "string",      "license": "CC-BY-4.0",      "notice": "from Bixel",      "data_version": "string"    }  }}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}