GET

Get residency attestation

Get user's current resolved geo-attestation for the jurisdiction derived from the request's IP geolocation.

Header Params

user-id string required

User id of the user making the request.

at least 1 characters

Responses

200

Response Body

object

codec for the GET /api/link/v1/attestation/status response

geoAttestation object required

The user's resolved geo-attestation for the jurisdiction derived from their request IP. country is the ISO 3166-1 alpha-3 code resolved from the request's geolocation and is always present; subdivision is the bare ISO 3166-2 subdivision code (e.g. NY) and is omitted for country-level jurisdictions.

not_attested covers both a user who has never attested for the jurisdiction and one whose latest attestation has expired — in both cases attestedAt and expiresAt are omitted, since no attestation is currently in force.
geoAttestation object
- country string required
  
  ISO 3166-1 alpha-3 code of the request's IP-derived jurisdiction.
  
  at least 1 characters
- subdivision string
  
  Bare ISO 3166-2 subdivision code (e.g. NY); omitted for country-level jurisdictions.
- attestationStatus string enum required
  
  The resolved attestation state for the jurisdiction.
  
  not_attestedattested_unrestrictedattested_restricted
- attestedAt string date-time
  
  When the winning attestation was recorded; omitted while not_attested.
- expiresAt string date-time
  
  When the winning attestation stops being valid; omitted while not_attested.

400

Bad Request

No response body

401

Unauthorized

Response Body

object

Standard structured error response payload for Link API v1 error responses. Contains an error name and human-readable error message.

errorName string required
error string required

403

Forbidden

Response Body

object

Standard structured error response payload for Link API v1 error responses. Contains an error name and human-readable error message.

errorName string required
error string required

422

Unprocessable Entity

Response Body

object

Standard structured error response payload for Link API v1 error responses. Contains an error name and human-readable error message.

errorName string required
error string required

500

Internal Server Error

Response Body

object

Standard structured error response payload for Link API v1 error responses. Contains an error name and human-readable error message.

errorName string required
error string required

curl -X GET \ --url 'https://app.bitgo-test.com/api/link/v1/attestation/status' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'user-id: string'

const url = 'https://app.bitgo-test.com/api/link/v1/attestation/status'; const options = {method: 'GET', headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', 'user-id': 'string'}}; fetch(url, options) .then(res => res.json()) .then(json => console.log(json)) .catch(err => console.error(err));

require 'uri' require 'net/http' url = URI("https://app.bitgo-test.com/api/link/v1/attestation/status") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' request["user-id"] = 'string' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('GET', 'https://app.bitgo-test.com/api/link/v1/attestation/status', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', 'user-id' => 'string', ], ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/link/v1/attestation/status" headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN", "user-id": "string" } response = requests.get(url, headers=headers) print(response.text)