---
title: "List"
method: GET
path: "/v2/issuers/{organizationId}/children"
tags: ["Organizations > Children"]
---

# List

`GET /v2/issuers/{organizationId}/children`

## Request

- Base URL: `https://rewards-api.getkard.com`
- URL: `https://rewards-api.getkard.com/v2/issuers/{organizationId}/children`
- Auth: HTTP bearer

List child organizations belonging to the authenticated issuer

## Path parameters

- `organizationId` string, required

## Query parameters

- `page[after]` string
- `page[size]` integer

## Response `200`

Paginated list of child organizations

- OrganizationsChildrenChildOrganizationListResponse: Paginated list of child organizations
  - `data` OrganizationsChildrenChildOrganizationResponse[], required: Array of child organization resources
    - `type` 'organization', required
    - `id` string, required: Unique identifier of the child organization
    - `attributes` OrganizationsChildrenChildOrganizationAttributes, required: Limited set of child organization attributes exposed to external consumers
      - `name` string, required: Name of the child organization (at least two letters or numbers; letters, numbers, and spaces only)
      - `externalId` string: External identifier for the child organization
      - `bins` string[], required: Bank Identification Numbers for the child organization
  - `links` CommonsLinks: Related links to the API call
    - `self` string, required
    - `prev` string
    - `next` string
  - `meta` InternalOrganizationsOrganizationPaginationMetadata: Pagination metadata for organization list responses
    - `pageSize` integer, required: Number of items per page
    - `hasNextPage` boolean, required: Whether more pages are available

## Other responses

- `401`: Error response with status 401
- `403`: Error response with status 403
- `404`: Error response with status 404
- `429`: The issuer's traffic grew faster than its allowed rate, or the endpoint's own limit was reached. If the response includes a `Retry-After` header, wait that many seconds before retrying. See [Rate Limits](/2024-10-01/api/integration-guides/rate-limits).
- `500`: Error response with status 500

## Changes

- **2026-10-22** `4e87fc8b018b`: 1 info
  - added the non-success response with the status `429`

[Operation history](https://skmtc.dev/getkard/apis/getkard-2/changes/v2/issuers/:organizationId/children/get.md)

---

[API](https://skmtc.dev/getkard/apis/getkard-2.md) - [All operations](https://skmtc.dev/getkard/apis/getkard-2/llms.txt) - [OpenAPI document](https://skmtc.dev/getkard/apis/getkard-2/revisions/bd47764afa21?raw)