> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solo.one/llms.txt
> Use this file to discover all available pages before exploring further.

# Read a page of one model's objects.

> Read a page of objects for one graph model.

Parameters
----
`resource` : `str`.
    Resource path segment, as reported by ``GET /v1/graph/models``.

`network_id` : `list[UUID]`.
    Networks to read within. Repeat the parameter to widen the scope;
    omit it to use every network the caller can reach.

`expand` : `str`, optional.
    Comma-separated relationship names to include inline, every field.

`fields` : `list[str]`.
    Fields to read, comma-separated or one per repeated parameter;
    dotted paths reach through relationships. Every scalar of the
    resource when omitted.

`limit` : `int`.
    Page size (1-100). Defaults to 25.

`offset` : `int`.
    Rows to skip before the page.

Returns
----
`page` : `GraphObjectsResponse`.
    The page of objects, with the limit and offset it was read at.

Examples
-----
```
GET /v1/graph/consumer_identities?limit=10&expand=address_identities
GET /v1/graph/consumer_identities?fields=firstName,address_identities.city
GET /v1/graph/consumer_identities?fields=firstName&fields=address_identities.city
```



## OpenAPI

````yaml GET /v1/graph/{resource}
openapi: 3.1.0
info:
  title: SOLO Network API
  version: v1
servers:
  - url: https://api.solo.one
    description: Production
  - url: https://api.sandbox.solo.one
    description: Sandbox
security: []
paths:
  /v1/graph/{resource}:
    get:
      tags:
        - Graph
      summary: Read a page of one model's objects.
      description: >-
        Read a page of objects for one graph model.


        Parameters

        ----

        `resource` : `str`.
            Resource path segment, as reported by ``GET /v1/graph/models``.

        `network_id` : `list[UUID]`.
            Networks to read within. Repeat the parameter to widen the scope;
            omit it to use every network the caller can reach.

        `expand` : `str`, optional.
            Comma-separated relationship names to include inline, every field.

        `fields` : `list[str]`.
            Fields to read, comma-separated or one per repeated parameter;
            dotted paths reach through relationships. Every scalar of the
            resource when omitted.

        `limit` : `int`.
            Page size (1-100). Defaults to 25.

        `offset` : `int`.
            Rows to skip before the page.

        Returns

        ----

        `page` : `GraphObjectsResponse`.
            The page of objects, with the limit and offset it was read at.

        Examples

        -----

        ```

        GET /v1/graph/consumer_identities?limit=10&expand=address_identities

        GET
        /v1/graph/consumer_identities?fields=firstName,address_identities.city

        GET
        /v1/graph/consumer_identities?fields=firstName&fields=address_identities.city

        ```
      operationId: list_graph_objects_v1_graph__resource__get
      parameters:
        - name: resource
          in: path
          required: true
          schema:
            type: string
            description: Resource path from /graph/models, e.g. ``consumer-identities``
            title: Resource
          description: Resource path from /graph/models, e.g. ``consumer-identities``
        - name: network_id
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
              format: uuid
            description: Network scope; repeat to widen
            default: []
            title: Network Id
          description: Network scope; repeat to widen
        - name: expand
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Comma-separated relationships to expand
            title: Expand
          description: Comma-separated relationships to expand
        - name: fields
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
            description: >-
              Fields to read, comma-separated or one per repeated parameter. A
              dotted path reaches through relationships, e.g.
              ``firstName,addressIdentities.city``. Omit to read every scalar of
              the resource.
            default: []
            title: Fields
          description: >-
            Fields to read, comma-separated or one per repeated parameter. A
            dotted path reaches through relationships, e.g.
            ``firstName,addressIdentities.city``. Omit to read every scalar of
            the resource.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Page size
            default: 25
            title: Limit
          description: Page size
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: Rows to skip
            default: 0
            title: Offset
          description: Rows to skip
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphObjectsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    GraphObjectsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/GraphObject'
          type: array
          title: Data
        limit:
          type: integer
          title: Limit
        offset:
          type: integer
          title: Offset
      type: object
      required:
        - limit
        - offset
      title: GraphObjectsResponse
      description: A page of graph objects.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    GraphObject:
      properties:
        model:
          type: string
          title: Model
          description: Model name this object belongs to
        id:
          type: string
          title: Id
          description: Global id, stable across the graph
        identifier:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Identifier
          description: Row id
        attributes:
          additionalProperties: true
          type: object
          title: Attributes
          description: Scalar fields, keyed by field name
        relationships:
          additionalProperties: true
          type: object
          title: Relationships
          description: >-
            Relationships read inline, keyed by field name: those named in
            ``expand``, and those a dotted path in ``fields`` reaches through.
      type: object
      required:
        - model
        - id
      title: GraphObject
      description: One row of the graph.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.