GET /v1/apiCollections/{id}

from metadata.sdk import configure
from metadata.sdk.entities import APICollections

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# Get by ID
ac = APICollections.retrieve("0f7ee81c-8163-4097-8adb-45c3d6c7b14b")
print(f"{ac.fullyQualifiedName}: {ac.description}")

# Get by ID with fields
ac = APICollections.retrieve(
    "0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
    fields=["owners", "tags"]
)

# Get by fully qualified name
ac = APICollections.retrieve_by_name("sample_api_service.pet")

# Get by name with fields
ac = APICollections.retrieve_by_name(
    "sample_api_service.pet",
    fields=["owners", "tags", "domain"]
)

import static org.openmetadata.sdk.fluent.APICollections.*;

// Get by ID
var ac = APICollections.retrieve("0f7ee81c-8163-4097-8adb-45c3d6c7b14b");

// Get by ID with fields
var ac = APICollections.retrieve(
    "0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
    "owners,tags"
);

// Get by fully qualified name
var ac = APICollections.retrieveByName(
    "sample_api_service.pet"
);

// Get by name with fields
var ac = APICollections.retrieveByName(
    "sample_api_service.pet",
    "owners,tags,domain"
);

# Get by ID
curl "{base_url}/api/v1/apiCollections/0f7ee81c-8163-4097-8adb-45c3d6c7b14b" \
  -H "Authorization: Bearer {access_token}"

# Get by ID with fields
curl "{base_url}/api/v1/apiCollections/0f7ee81c-8163-4097-8adb-45c3d6c7b14b?fields=owners,tags,domains" \
  -H "Authorization: Bearer {access_token}"

# Get by fully qualified name
curl "{base_url}/api/v1/apiCollections/name/sample_api_service.pet" \
  -H "Authorization: Bearer {access_token}"

# Get by name with fields
curl "{base_url}/api/v1/apiCollections/name/sample_api_service.pet?fields=owners,tags,domains" \
  -H "Authorization: Bearer {access_token}"

{
  "id": "0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
  "name": "pet",
  "fullyQualifiedName": "sample_api_service.pet",
  "version": 0.1,
  "updatedAt": 1769982733673,
  "updatedBy": "admin",
  "endpointURL": "https://petstore3.swagger.io/#/pet",
  "href": "http://localhost:8585/api/v1/apiCollections/0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
  "owners": [],
  "tags": [],
  "service": {
    "id": "58d413a8-abc3-4a6d-bd8a-13a0234b1ff8",
    "type": "apiService",
    "name": "sample_api_service",
    "fullyQualifiedName": "sample_api_service",
    "deleted": false
  },
  "serviceType": "Rest",
  "deleted": false,
  "domains": []
}

GET

apiCollections

{id}

GET /v1/apiCollections/{id}

from metadata.sdk import configure
from metadata.sdk.entities import APICollections

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# Get by ID
ac = APICollections.retrieve("0f7ee81c-8163-4097-8adb-45c3d6c7b14b")
print(f"{ac.fullyQualifiedName}: {ac.description}")

# Get by ID with fields
ac = APICollections.retrieve(
    "0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
    fields=["owners", "tags"]
)

# Get by fully qualified name
ac = APICollections.retrieve_by_name("sample_api_service.pet")

# Get by name with fields
ac = APICollections.retrieve_by_name(
    "sample_api_service.pet",
    fields=["owners", "tags", "domain"]
)

import static org.openmetadata.sdk.fluent.APICollections.*;

// Get by ID
var ac = APICollections.retrieve("0f7ee81c-8163-4097-8adb-45c3d6c7b14b");

// Get by ID with fields
var ac = APICollections.retrieve(
    "0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
    "owners,tags"
);

// Get by fully qualified name
var ac = APICollections.retrieveByName(
    "sample_api_service.pet"
);

// Get by name with fields
var ac = APICollections.retrieveByName(
    "sample_api_service.pet",
    "owners,tags,domain"
);

# Get by ID
curl "{base_url}/api/v1/apiCollections/0f7ee81c-8163-4097-8adb-45c3d6c7b14b" \
  -H "Authorization: Bearer {access_token}"

# Get by ID with fields
curl "{base_url}/api/v1/apiCollections/0f7ee81c-8163-4097-8adb-45c3d6c7b14b?fields=owners,tags,domains" \
  -H "Authorization: Bearer {access_token}"

# Get by fully qualified name
curl "{base_url}/api/v1/apiCollections/name/sample_api_service.pet" \
  -H "Authorization: Bearer {access_token}"

# Get by name with fields
curl "{base_url}/api/v1/apiCollections/name/sample_api_service.pet?fields=owners,tags,domains" \
  -H "Authorization: Bearer {access_token}"

{
  "id": "0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
  "name": "pet",
  "fullyQualifiedName": "sample_api_service.pet",
  "version": 0.1,
  "updatedAt": 1769982733673,
  "updatedBy": "admin",
  "endpointURL": "https://petstore3.swagger.io/#/pet",
  "href": "http://localhost:8585/api/v1/apiCollections/0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
  "owners": [],
  "tags": [],
  "service": {
    "id": "58d413a8-abc3-4a6d-bd8a-13a0234b1ff8",
    "type": "apiService",
    "name": "sample_api_service",
    "fullyQualifiedName": "sample_api_service",
    "deleted": false
  },
  "serviceType": "Rest",
  "deleted": false,
  "domains": []
}

Retrieve an API Collection

Get a single API collection by its unique ID or fully qualified name.

Get by ID

string

required

UUID of the API collection to retrieve.

string

Comma-separated list of fields to include (e.g., owners,tags,extension,domains,sourceHash).

string

default:"non-deleted"

Include all, deleted, or non-deleted entities.

Get by Fully Qualified Name

Use GET /v1/apiCollections/name/{fqn} to retrieve by fully qualified name.

string

required

Fully qualified name of the API collection (e.g., sample_api_service.pet).

string

Comma-separated list of fields to include: owners, tags, extension, domains, sourceHash.

string

default:"non-deleted"

Include all, deleted, or non-deleted entities.

GET /v1/apiCollections/{id}

from metadata.sdk import configure
from metadata.sdk.entities import APICollections

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# Get by ID
ac = APICollections.retrieve("0f7ee81c-8163-4097-8adb-45c3d6c7b14b")
print(f"{ac.fullyQualifiedName}: {ac.description}")

# Get by ID with fields
ac = APICollections.retrieve(
    "0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
    fields=["owners", "tags"]
)

# Get by fully qualified name
ac = APICollections.retrieve_by_name("sample_api_service.pet")

# Get by name with fields
ac = APICollections.retrieve_by_name(
    "sample_api_service.pet",
    fields=["owners", "tags", "domain"]
)

import static org.openmetadata.sdk.fluent.APICollections.*;

// Get by ID
var ac = APICollections.retrieve("0f7ee81c-8163-4097-8adb-45c3d6c7b14b");

// Get by ID with fields
var ac = APICollections.retrieve(
    "0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
    "owners,tags"
);

// Get by fully qualified name
var ac = APICollections.retrieveByName(
    "sample_api_service.pet"
);

// Get by name with fields
var ac = APICollections.retrieveByName(
    "sample_api_service.pet",
    "owners,tags,domain"
);

# Get by ID
curl "{base_url}/api/v1/apiCollections/0f7ee81c-8163-4097-8adb-45c3d6c7b14b" \
  -H "Authorization: Bearer {access_token}"

# Get by ID with fields
curl "{base_url}/api/v1/apiCollections/0f7ee81c-8163-4097-8adb-45c3d6c7b14b?fields=owners,tags,domains" \
  -H "Authorization: Bearer {access_token}"

# Get by fully qualified name
curl "{base_url}/api/v1/apiCollections/name/sample_api_service.pet" \
  -H "Authorization: Bearer {access_token}"

# Get by name with fields
curl "{base_url}/api/v1/apiCollections/name/sample_api_service.pet?fields=owners,tags,domains" \
  -H "Authorization: Bearer {access_token}"

{
  "id": "0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
  "name": "pet",
  "fullyQualifiedName": "sample_api_service.pet",
  "version": 0.1,
  "updatedAt": 1769982733673,
  "updatedBy": "admin",
  "endpointURL": "https://petstore3.swagger.io/#/pet",
  "href": "http://localhost:8585/api/v1/apiCollections/0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
  "owners": [],
  "tags": [],
  "service": {
    "id": "58d413a8-abc3-4a6d-bd8a-13a0234b1ff8",
    "type": "apiService",
    "name": "sample_api_service",
    "fullyQualifiedName": "sample_api_service",
    "deleted": false
  },
  "serviceType": "Rest",
  "deleted": false,
  "domains": []
}

Returns

Returns an API collection object with all requested fields populated.

Response

string

Unique identifier for the API collection (UUID format).

string

API collection name.

string

Fully qualified name in format service.collectionName.

string

Human-readable display name.

string

Description of the API collection in Markdown format.

string

Base URL for the API collection.

object

Reference to the parent API service.

Show properties

string

UUID of the API service.

string

Type of entity (always apiService).

string

Name of the API service.

string

Fully qualified name of the API service.

string

Type of API service (e.g., Rest).

number

Version number for the entity.

array

List of owners. Only included when fields contains owners.

array

Classification tags. Only included when fields contains tags.

array

Domain assignments. Only included when fields contains domains.

Error Handling

Code	Error Type	Description
`401`	`UNAUTHORIZED`	Invalid or missing authentication token
`403`	`FORBIDDEN`	User lacks permission to view this API collection
`404`	`NOT_FOUND`	API collection with given ID or FQN does not exist

List API Collections

Update an API Collection

API Reference

Data Assets

AI SDK

SDK

Discovery

Lineage

Data Contracts

Teams And Users

Data Governance

Data Quality

Main Concepts

Retrieve an API Collection

Retrieve an API Collection

Get by ID

Get by Fully Qualified Name

Returns

Response

Error Handling

​Retrieve an API Collection

​Get by ID

​Get by Fully Qualified Name

​Returns

​Response

​Error Handling

Retrieve an API Collection

Get by ID

Get by Fully Qualified Name

Returns

Response

Error Handling