Developer Reference

API Documentation

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

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, OAuth 2.0 flows, 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

Download the full OpenAPI 3.0 specification 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
Plus webhook configuration, GraphQL queries, 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",
      "status": "LOA_SUBMITTED",
      "state": "documents_submitted",
      "participant": {
        "firstName": "John",
        "lastName": "Doe"
      },
      "createdAt": "2025-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1, "limit": 20,
    "total": 1, "hasNext": false
  }
}

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

Get Access to Full Documentation

Schedule a call to get your API keys and access to the complete interactive docs

Schedule a Call with Our Team

Fill out the form below and we'll reach out to set up a time that works for you.