---
title: "ResponsibleUplineFirmV2Page"
url: "https://developer.agentsync.io/apis/contracting-hierarchies-api/versions/40f58935-396e-4da4-8f47-1587041e1b16/schemas/ResponsibleUplineFirmV2Page"
---

> Full API specification: https://developer.agentsync.io/apis/contracting-hierarchies-api/versions/40f58935-396e-4da4-8f47-1587041e1b16.md

# ResponsibleUplineFirmV2Page

A token-paginated page of responsible upline firms (plain envelope, no HAL wrappers).

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: AgentSync Contracting & Hierarchies API
  version: v1.7.6
servers:
  - url: https://api.sandbox.agentsync.io/contracting
    description: Sandbox
  - url: https://api.agentsync.io/contracting
    description: Production
components:
  schemas:
    ResponsibleUplineFirmV2:
      type: object
      description: A firm responsible for upline relationships in an organization.
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        npn:
          type: string
        fein:
          type: string
        testAccount:
          type: boolean
      required:
        - id
    PageInfo:
      type: object
      description: Pagination metadata for a V2 list response.
      properties:
        size:
          type: integer
          description: Number of items returned in this response (equal to items.length).
        nextToken:
          type:
            - string
            - "null"
          description: Opaque continuation token for the next page, or null on the last
            page.
      required:
        - size
        - nextToken
    ResponsibleUplineFirmV2Page:
      type: object
      description: A token-paginated page of responsible upline firms (plain envelope,
        no HAL wrappers).
      properties:
        items:
          type: array
          items:
            $ref: "#/components/schemas/ResponsibleUplineFirmV2"
        page:
          $ref: "#/components/schemas/PageInfo"
      required:
        - items
        - page
```