> ## 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.

# Describe every model in the data graph.

> Describe the data graph: each model, its resource path, and its fields.

Products and policies are both projections of this graph, so this is the
ground truth either one is defined against. Call it to discover which
resources exist and which relationships can be expanded.

Returns
----
`models` : `GraphModelsResponse`.
    One entry per model the graph serves.

Examples
-----
```
GET /v1/graph/models
```



## OpenAPI

````yaml GET /v1/graph/models
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/models:
    get:
      tags:
        - Graph
      summary: Describe every model in the data graph.
      description: |-
        Describe the data graph: each model, its resource path, and its fields.

        Products and policies are both projections of this graph, so this is the
        ground truth either one is defined against. Call it to discover which
        resources exist and which relationships can be expanded.

        Returns
        ----
        `models` : `GraphModelsResponse`.
            One entry per model the graph serves.

        Examples
        -----
        ```
        GET /v1/graph/models
        ```
      operationId: list_graph_models_v1_graph_models_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphModelsResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    GraphModelsResponse:
      properties:
        models:
          items:
            $ref: '#/components/schemas/GraphModelSchema'
          type: array
          title: Models
      type: object
      title: GraphModelsResponse
      description: 'The graph''s shape: every model this surface serves.'
    GraphModelSchema:
      properties:
        name:
          type: string
          title: Name
          description: Model name, e.g. ``AddressIdentity``
        resource:
          type: string
          title: Resource
          description: Path segment for this model, e.g. ``address-identities``
        listable:
          type: boolean
          title: Listable
          description: >-
            Whether the collection endpoint serves this model. Models reachable
            only through a relationship are fetched by id or via ``expand``.
        fields:
          items:
            $ref: '#/components/schemas/GraphFieldSchema'
          type: array
          title: Fields
          description: Scalar fields
        relationships:
          items:
            $ref: '#/components/schemas/GraphFieldSchema'
          type: array
          title: Relationships
          description: Fields pointing at other graph models
      type: object
      required:
        - name
        - resource
        - listable
      title: GraphModelSchema
      description: A model in the data graph, addressable as a REST resource.
    GraphFieldSchema:
      properties:
        name:
          type: string
          title: Name
          description: Field name, camelCase as the graph exposes it
        type:
          type: string
          title: Type
          description: GraphQL type name of the field
        is_list:
          type: boolean
          title: Is List
          description: Whether the field holds many values
          default: false
        is_required:
          type: boolean
          title: Is Required
          description: Whether the graph guarantees a value
          default: false
        target_model:
          anyOf:
            - type: string
            - type: 'null'
          title: Target Model
          description: Model this field points at, for relationships
      type: object
      required:
        - name
        - type
      title: GraphFieldSchema
      description: One field of a graph model, as served over REST.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````

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