---
title: "API Reference"
description: "Endpoint reference for the Gravv API Gateway."
hideRightSidebar: true
---

# API Reference

Use these pages for endpoint-specific request and response details. All requests use the base URL `https://api.gravv.xyz/v1/` and authenticate with the `Api-Key` header.

## Before you start

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/getting-started/authentication">
    Create API keys and authenticate with the Api-Key header.
  </Card>
  <Card title="Idempotent requests" icon="refresh-cw" href="/getting-started/idempotent-requests">
    Make write requests safe to retry with the Idempotency-Key header.
  </Card>
  <Card title="Errors" icon="alert-triangle" href="/getting-started/errors">
    Understand error shapes and status codes across the API.
  </Card>
  <Card title="Rate limits" icon="clock" href="/getting-started/rate-limits">
    Stay within request limits and handle 429 responses.
  </Card>
</CardGroup>

## Resources

<CardGroup cols={3}>
  <Card title="Customers" icon="users" href="/api-reference/customers/overview">
    Create and manage customer records.
  </Card>
  <Card title="KYC" icon="shield" href="/api-reference/kyc/overview">
    Verify customers and retrieve verification status.
  </Card>
  <Card title="Features" icon="settings" href="/api-reference/features/overview">
    List, check, and activate account features.
  </Card>
  <Card title="Accounts" icon="database" href="/api-reference/accounts/overview">
    Open and manage customer accounts.
  </Card>
  <Card title="External Accounts" icon="link" href="/api-reference/external-accounts/overview">
    Manage recipients outside Gravv.
  </Card>
  <Card title="Transfers" icon="zap" href="/api-reference/transfer/overview">
    Move funds and retrieve transfer rates.
  </Card>
  <Card title="Cards" icon="key" href="/api-reference/cards/overview">
    Issue and manage virtual and physical cards.
  </Card>
  <Card title="Collections" icon="layers" href="/api-reference/collections/overview">
    Initiate collections and manage payment intents.
  </Card>
  <Card title="Payment Links" icon="link" href="/api-reference/payment-links/overview">
    Create and manage shareable crypto payment links.
  </Card>
  <Card title="Wallets" icon="lock" href="/api-reference/wallets/overview">
    Create and retrieve blockchain wallets.
  </Card>
  <Card title="Foreign Exchange" icon="globe" href="/api-reference/fx/overview">
    Retrieve rates and manage FX orders.
  </Card>
  <Card title="Transactions" icon="terminal" href="/api-reference/transactions/overview">
    Retrieve, inspect, and export transactions.
  </Card>
  <Card title="Webhooks" icon="zap" href="/api-reference/webhooks/overview">
    Inspect events, delivery history, and retries.
  </Card>
  <Card title="Risk (deprecated)" icon="shield" href="/api-reference/risk-deprecated/overview">
    Maintain legacy verification integrations.
  </Card>
</CardGroup>
