Skip to content

List Attestations

This endpoint lets you list all attestations tied to a specific stablecoin. You can filter by attestation type (mint/burn), status (pending, submitted, verified, rejected), and paginate through results.

Prerequisites

Before you begin, ensure:

You have the stablecoinId of the deployed token

Endpoint

GET /v2/stablecoin/{stablecoinId}/attestations

Query Parameters

GET /v2/stablecoin/stablecoin_abc123/attestations?type=mint&status=verified&page[number]=1&page[size]=10

type: Optional. Filter by mint or burn
status: Optional. Filter by pending, submitted, verified, rejected
page[number]: Page number (default: 1)
page[size]: Page size (default: 10)

Example Request

curl -X GET "https://api.fsco.io/v2/stablecoin/{{stablecoinId}}/attestations?type=mint&status=verified&page[number]=1&page[size]=10" \
  -H "Authorization: Bearer $FSCO_API_KEY"

import axios from 'axios';

const FSCO_API_KEY = process.env.FSCO_API_KEY;

const listAttestations = async () => {
  const response = await axios.get(
    'https://api.fsco.io/v2/stablecoin/{{stablecoinId}}/attestations',
    {
      params: {
        type: 'mint',
        status: 'verified',
        'page[number]': 1,
        'page[size]': 10
      },
      headers: {
        Authorization: `Bearer ${FSCO_API_KEY}`
      }
    }
  );

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

listAttestations();

import requests
import os

FSCO_API_KEY = os.getenv("FSCO_API_KEY")

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

params = {"type": "mint", "status": "verified", "page[number]": 1, "page[size]": 10}

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

print("Attestations:", 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 url = "https://api.fsco.io/v2/stablecoin/{{stablecoinId}}/attestations?type=mint&status=verified&page[number]=1&page[size]=10";
        var response = await client.GetAsync(url);
        var responseString = await response.Content.ReadAsStringAsync();

        Console.WriteLine("Attestations: " + responseString);
    }
}

Response

Response

{
  "attestations": [
    {
      "id": "{{attestationId}}",
      "type": "mint",
      "status": "verified",
      "amount": "1000000000000000000",
      "submitterWalletId": "{{walletId}}",
      "verifierWalletId": "{{walletId}}",
      "createdAt": "2025-05-08T12:01:00Z",
      "verifiedAt": "2025-05-08T12:05:00Z",
      "usedAt": "2025-05-08T12:07:00Z",
      "transactionHash": "0xabc123..."
    }
  ],
  "page": {
    "number": 1,
    "size": 10,
    "totalPages": 1,
    "totalCount": 1
  }
}

Each attestation record includes:

IDs and type/status
Amount and wallet roles
Lifecycle timestamps (createdAt, verifiedAt, usedAt)
Optional transactionHash if executed

Next Steps