---
name: backup-recovery-baas-service-endpoints
title: Service endpoints
description: Access IBM Cloud Backup and Recovery by using the listed endpoints for each supported IBM Cloud location.
last-updated: 2025-08-27
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/backup-recovery?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Service endpoints
{: #endpoints}

Access IBM Cloud Backup and Recovery by using the listed endpoints for each supported IBM Cloud location.
{: shortdesc}


## Private endpoints
{: #private-endpoints}

Private endpoints restrict access to the IBM Cloud private network.  Both the API and service backup support private endpoints.

| Geography | Region                           | API Endpoint | Backup Endpoint |
|-----------|----------------------------------|---------------------|--------------------|
| United States  | Washington MZR (`us-east`) | `<instance_ID>.private.us-east.backup-recovery.cloud.ibm.com` | `<instance_ID>.private.us-east.backup-recovery.cloud.ibm.com` |
{: caption="List of IBM Cloud Backup and Recovery private endpoints" caption-side="top"}


When you connect by using a [VPE](https://cloud.ibm.com/docs/vpc?topic=vpc-about-vpe&format=markdown) or [CSE](https://cloud.ibm.com/docs/account?topic=account-service-endpoints-overview&format=markdown), use port 443 with API and and port 29991 with the backup endpoints.
{: important}

## Querying the service endpoints with the CLI
{: #endpoints-cli}
{: cli}

To retrieve the service endpoints of a IBM Cloud Backup and Recovery instance using IBM Cloud CLI, use the command illustrated below:

`ibmcloud resource service-instance (NAME|ID) --output json`

The endpoint information for a service is available as part of the `extensions` blob in the response json.

```json
{
    "extensions": {
        "endpoints": {
           "public": "https://<instance_ID>.us-east.backup-recovery.cloud.ibm.com",
           "private": "https://<instance_ID>.private.us-east.backup-recovery.cloud.ibm.com"
        }
    }
}
```

## Querying the service endpoints with the API
{: #endpoints-api}
{: api}

The service endpoint information can be queried using the [Global Search API](https://cloud.ibm.com/apidocs/search#search) as illustrated below:

```shell
# Search using service instance name
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: bearer <your IAM token>' -d '{"query": "type:resource-instance AND name:ABC","fields": ["*"]}' 'https://api.global-search-tagging.cloud.ibm.com/v3/resources/search?limit=1'

# Search using service instance guid
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: bearer <your IAM token>' -d '{"query": "type:resource-instance AND service_instance:9613ab9d-9749-4ef7-82b9-56cd023492e5","fields": ["doc.extensions.endpoints.private"]}' 'https://api.global-search-tagging.cloud.ibm.com/v3/resources/search?limit=1'
```