Skip to content

Get Attestation Details

Use this endpoint to retrieve a complete view of a mint or burn attestation. It returns all metadata including involved wallets, amounts, status, timestamps, documents, and execution results.

Prerequisites

Before you begin, ensure:

You have both the stablecoinId and the attestationId

Endpoint

GET /v2/stablecoin/{stablecoinId}/attestation/{attestationId}

Example Request

curl -X GET https://api.fsco.io/v2/stablecoin/{{stablecoinId}}/attestation/{{attestationId}} \
  -H "Authorization: Bearer $FSCO_API_KEY"

import axios from 'axios';

const FSCO_API_KEY = process.env.FSCO_API_KEY;

const getAttestation = async () => {
  const response = await axios.get(
    'https://api.fsco.io/v2/stablecoin/{{stablecoinId}}/attestation/{{attestationId}}',
    {
      headers: {
        Authorization: `Bearer ${FSCO_API_KEY}`
      }
    }
  );

  console.log('Attestation details:', response.data);
};

getAttestation();

import requests
import os

FSCO_API_KEY = os.getenv("FSCO_API_KEY")

headers = {"Authorization": f"Bearer {FSCO_API_KEY}"}

response = requests.get(
    "https://api.fsco.io/v2/stablecoin/{{stablecoinId}}/attestation/{{attestationId}}",
    headers=headers,
)

print("Attestation details:", response.json())

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var apiKey = Environment.GetEnvironmentVariable("FSCO_API_KEY");

        var client = new HttpClient();
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);

        var response = await client.GetAsync("https://api.fsco.io/v2/stablecoin/{{stablecoinId}}/attestation/{{attestationId}}");
        var responseString = await response.Content.ReadAsStringAsync();

        Console.WriteLine("Attestation details: " + responseString);
    }
}

Response

Response

{
  "id": "{{attestationId}}",
  "type": "mint",
  "status": "verified",
  "amount": "1000000000000000000",
  "submitterWalletId": "{{walletId}}",
  "verifierWalletId": "{{walletId}}",
  "transactionHash": "0xabc123...",
  "transactionReference": "WIRE-REF-2025-001",
  "transactionDate": "2025-05-08T12:00:00Z",
  "createdAt": "2025-05-08T12:01:00Z",
  "verifiedAt": "2025-05-08T12:05:00Z",
  "usedAt": "2025-05-08T12:07:00Z",
  "additionalNotes": "USDC treasury deposit received",
  "documents": [
    {
      "blobId": "{{blobId}}"
    }
  ]
}

The response includes:

Attestation metadata (type, amount, status)
Lifecycle timestamps (created, verified, executed)
Associated wallets: submitter, verifier, signer
Transaction metadata including transactionReference, transactionHash, and attached documents

Next Steps