---
title: "ID4ns of a privilege"
method: GET
path: "/api/v1/apikeys/{key}/privileges/{privilege}/id4ns"
tags: ["Api Keys"]
---

# ID4ns of a privilege

`GET /api/v1/apikeys/{key}/privileges/{privilege}/id4ns`

## Request

- Base URL: `https://backend.id4i.de`
- URL: `https://backend.id4i.de/api/v1/apikeys/{key}/privileges/{privilege}/id4ns`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/id4i/apis/id4i-api/docs/api/v1/apikeys/:key/privileges/:privilege/id4ns/get.ts> (a function with typed inputs; its response is checked against the schema)

Listing ID4ns of a id4n concerning privilege

## Path parameters

- `key` string, required
- `privilege` string, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

OK

- PaginatedResponseOfId4nPresentation
  - `elements` Id4nPresentation[], required
    - `createdTimestamp` integer: The UTC unix timestamp of when this ID has been created
    - `holderOrganizationId` string: Organization namespace of the holder of the ID
    - `id4n` string: The ID
    - `label` string
    - `ownerOrganizationId` string: Organization namespace of the ID owner
    - `properties` object: The properties of the organization
    - `type` 'GUID' | 'ROUTING_COLLECTION' | 'LOGISTIC_COLLECTION' | 'LABELLED_COLLECTION': The type of ID
  - `limit` integer, required: The number of returned elements
  - `offset` integer, required: Starting with the n-th element
  - `total` integer: The total number of elements

## Other responses

- `202`: Accepted
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method not allowed
- `406`: Not Acceptable
- `415`: Unsupported Media Type
- `500`: Internal Server Error

---

[API](https://skmtc.dev/id4i/apis/id4i-api.md) - [All operations](https://skmtc.dev/id4i/apis/id4i-api/llms.txt) - [OpenAPI document](https://skmtc.dev/id4i/apis/id4i-api/revisions/b5f585ff1a29?raw)