{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api-docs/best-practices/base-urls/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Base URLs

\n

Ripple makes RESTful APIs available to integrate, manage and interact with Ripple products and services. To use these APIs, you need to use the correct base URL. A base URL is part of a well-formed REST URL.

\n

To form the final API request, append the necessary version, path, resource, and parameters to the base URL.

\n
All environments use unique base URLs

For more information on the correct base URL for the API environment you interact with, see Base URL by API environment.

\n

Components of a base URL

\n

A base URL includes the HTTPS protocol, the [domainPrefix], and the domain. A [domainPrefix] refers to a segment of the base URL that's variable depending on the API and environment.

\n\n

This example uses the test environment using the Ripple Payments API:

\n\n
\n
\n URL formatExample URL\n
\n
\n
\n
\n
Copy
\n
Copied!
\n
\n 
https://{domainPrefix}.{domain}/{apiVersion}/{path}?{parameters}
\n
\n
\n
Copy
\n
Copied!
\n
\n 
https://api.test.ripple.com/v2/identities
\n
\n
\n \n

The following table describes each component of a complete API request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Field
Example value
Description
ProtocolhttpsRipple uses the HTTPS protocol for all APIs.
Domain Prefixapi.testEach base URL is prefixed by api followed by an optional API environment.

Example: This example uses the api.test environment.
Domainripple.comThe Ripple Payments API uses ripple.com as the domain.
API Version/v2The latest Ripple Payments API version is /v2.
Path/identitiesThe path is appended to the base URL to reach the endpoint for the API operation.

This example targets the /v2/identities endpoint.
\n\n\n

Base URL for Ripple Payments API

\n

The Ripple Payments API includes a domain prefix that consists of api.{environment}.

\n
Note

The production environment does not have an environment variable.

\n

You can use Ripple Payments APIs in the following environments:

\n\n

Base URL by API environment

\n
Tokens are unique per environment

In addition to unique base URLs, access tokens are also unique per environment. Be sure to request the access token for the desired environment.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Environment
Domain Prefix
DomainBase URL
Testapi.test.ripple.comhttps://api.test.ripple.com/v2
Productionapi.ripple.comhttps://api.ripple.com/v2
\n

Note: The following examples use test environment.

\n\n
\n
\n URL Format Example Base URL Example fully-qualified URL \n
\n
\n
\n
\n
Copy
\n
Copied!
\n
\n 
https://{domainPrefix}.{domain}/{path}?{parameters}\n\n# This is the URL format.
\n
\n
\n
Copy
\n
Copied!
\n
\n 
https://api.test.ripple.com/\n\n# This is the base URL for the test environment.
\n
\n
\n
Copy
\n
Copied!
\n
\n 
https://api.test.ripple.com/v2/identities\n\n# This connects to the test environment and requests a list of identities.
\n
\n
\n ","headings":[{"value":"Base URLs","depth":1},{"value":"Components of a base URL","depth":2},{"value":"Base URL for Ripple Payments API","depth":2},{"value":"Base URL by API environment","depth":2}]},"contentItem":{"data":{"lastModified":"2025-11-13T00:24:58.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":true,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"2523a9aa-cd50-5ddc-a520-69053beda348__redocly content/api-docs/best-practices/base-urls/","seo":{"title":"Base URLs","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api-docs/best-practices/base-urls.md","pageBaseUrl":"/api-docs/best-practices/base-urls","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Base URLs","id":"base-urls"},{"depth":2,"value":"Components of a base URL","id":"components-of-a-base-url"},{"depth":2,"value":"Base URL for Ripple Payments API","id":"base-url-for-ripple-payments-api"},{"depth":2,"value":"Base URL by API environment","id":"base-url-by-api-environment"}]},"data":{"title":""},"catalogInfo":null,"link":"/api-docs/best-practices/base-urls/","sidebarName":"__root-sidebar__-data-69308394-sidebars.yaml","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}