---
title: API Basics
slug: apis/api-basics
description: Cross River's RESTful APIs, featuring allowlisting, idempotency, pagination, and versioning, ensuring robust access and streamlined data management.
docTags: 
createdAt: 2025-06-08T06:23:19.269Z
---

- [API structure](docId\:pUTTCwQ5SKLzxYzIn5D1b): Our APIs are organized around REST, have object oriented URLs, accept form-encoded request bodies, return JSON-encoded responses, and use standard HTTP response codes, authentication, and methods.
- [Static IPs](docId\:z3wbkvnCkkie3kEJtxLI9): At Cross River you need to allowlist your *static*, *public* IP address before you can access our products. Your IP is allowlisted as part of the partner onboarding process.
- [Idempotency](docId\:xQC2lRsG0xVv_9NMkqxKk): Cross River's COS system supports idempotency to retry requests without the risk of performing the request multiple times. This is especially useful in situations where there is a network outage, and you aren’t sure if a previous request has been processed successfully.
- [Pagination](docId:6EKvQUYWeVh9x4zxmuKlJ): Pagination is a process that divides a large dataset into smaller chunks. All endpoints that return a list of resources support pagination.
- [API versioning](docId\:IPfs2Poaow-MlHLbo0Yc3): All API endpoints contain a numbered version in the URL. Whenever breaking changes are made to the API, a new major version will be created.
- [HTTP status codes](docId\:O5LkHHUbBs7rmu7PXVSjP): Standard HTTP status codes that our system might return.