---
updatedAt: 2026-06-21T19:39:10.000Z
agentTools:
  projectIndex: https://developers.rebrandly.com/llms.txt
---

# /v1/domains

Get the list of domains shared in the current workspace.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Rebrandly Legacy",
    "description": "Transform your long URLs into short branded links",
    "termsOfService": "https://rebrandly.com/terms-conditions",
    "version": "1.0.0",
    "contact": {
      "url": "https://developers.rebrandly.com"
    }
  },
  "servers": [
    {
      "url": "https://api.rebrandly.com"
    }
  ],
  "components": {
    "schemas": {
      "SharedDomain": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "ddda4cc5b6ee45d6g7897b06ac2d1ain"
          },
          "fullName": {
            "type": "string",
            "example": "acme.com"
          }
        }
      }
    },
    "securitySchemes": {
      "viaApikey": {
        "type": "apiKey",
        "in": "header",
        "name": "apikey"
      }
    }
  },
  "security": [
    {
      "viaApikey": []
    }
  ],
  "paths": {
    "/v1/domains": {
      "get": {
        "summary": "/v1/domains",
        "description": "Get the list of domains shared in the current workspace.",
        "operationId": "getSharedDomains",
        "parameters": [
          {
            "name": "active",
            "in": "query",
            "description": "Filter branded domains depending on whether they can be used to brand short links or not",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "orderBy",
            "in": "query",
            "description": "Sorting criteria to apply to your branded domains collection among `createdAt`, `updatedAt` and `fullName`.",
            "schema": {
              "type": "string",
              "default": "createdAt"
            }
          },
          {
            "name": "orderDir",
            "in": "query",
            "description": "Sorting direction to apply to your branded short links collection among `desc` and `asc`.",
            "schema": {
              "type": "string",
              "default": "desc"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "How many branded domains to load (max: 25)",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 25
            }
          },
          {
            "name": "last",
            "in": "query",
            "description": "The id of the last domain you fetched, see Infinite Scrolling section",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspace",
            "in": "header",
            "description": "Which workspace id to filter shared domains by.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SharedDomain"
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "tags": [
          "Domains"
        ]
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": false,
    "samples-enabled": true
  }
}
```