Trust Rails
Solutions
About
Log in

API Documentation

Complete technical reference for the TrustRails REST and GraphQL APIs. Interactive docs, code examples, and OpenAPI specification.

Authentication
API Key + Bearer Token
Rate Limits
Up to 1,000 req/min
Sandbox
uat-api.trust-rails.com
Production
api.trust-rails.com

What's Covered

Everything you need to integrate with the TrustRails API

REST API Reference

Full endpoint documentation with request/response schemas, parameters, and examples.

GraphQL Schema

Complete GraphQL type definitions with query and mutation examples. Full introspection support.

Authentication

API key management, Bearer token auth, IP allowlisting, and security best practices.

Webhooks

Event types, payload formats, HMAC-SHA256 signature verification, and retry policies.

Error Codes

Complete error code reference with meanings, troubleshooting steps, and handling patterns.

OpenAPI Spec

Full OpenAPI 3.0 specification available upon integration for code generation and client SDK creation.

API Endpoints Preview

A sample of the core rollover endpoints available to custodian integrators

Base URL: https://api.trust-rails.com/v1
GET/v1/rollovers
POST/v1/rollovers
GET/v1/rollovers/{id}
GET/v1/rollovers/{id}/state
POST/v1/rollovers/{id}/actions
GET/v1/rollovers/{id}/timeline
GET/v1/partners
POST/v1/webhooks
POST/v1/webhooks/test
Plus GraphQL queries, plan search, and more

Code Examples

Quick look at how simple it is to work with the TrustRails API

List Rollovers
curl -X GET https://api.trust-rails.com/v1/rollovers \
  -H "Authorization: Bearer tr_live_ak_your_key_here" \
  -H "Content-Type: application/json"

# Response
{
  "data": [
    {
      "id": "rol_abc123",
      "state": "documents_submitted",
      "participant": {
        "firstName": "John",
        "lastName": "Doe"
      },
      "createdAt": "2026-04-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1, "limit": 20,
    "total": 1, "hasNext": false
  }
}
Webhook Payload
// POST to your webhook URL
// Header: X-TrustRails-Signature: <hmac_signature_hex>
// Header: X-TrustRails-Event: settlement.funds_sent
// Header: X-TrustRails-Timestamp: 2026-04-15T14:22:00Z

{
  "id": "wh_1735574000_a1b2c3d4",
  "eventId": "evt_abc123",
  "event": "settlement.funds_sent",
  "timestamp": "2026-04-15T14:22:00Z",
  "apiVersion": "v1",
  "data": {
    "rolloverId": "rol_abc123",
    "status": "funds_sent",
    "previousStatus": "transfer_executed",
    "settlement": {
      "method": "wire",
      "trackingNumber": "FED-202604151422-XYZ"
    }
  }
}

Full documentation includes examples for all endpoints, GraphQL queries, and webhook verification

Ready to Integrate?

Start building with the TrustRails API — explore the quickstart guide or request sandbox access

Read the QuickstartRequest API Access