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

# List contexts

> List the written contexts you can plan against, yours and your
organisation's, most recently updated first. Pass an id as context_id when
creating a project or simulation to plan against it.



## OpenAPI

````yaml https://api.semilattice.ai/openapi.json get /v1/contexts
openapi: 3.1.0
info:
  title: Semilattice API
  description: >-
    Plan and run simulations of how your users will react to your work, and read
    the results. Everything you create is saved in your Semilattice account, so
    it also appears in the app.


    Authenticate with an API key from **Settings → API Keys** in the app, sent
    as `Authorization: Bearer <key>`.
  contact:
    name: Semilattice API
    url: https://semilattice.ai/
    email: support@semilattice.ai
  version: v1.0.0
servers:
  - url: https://api.semilattice.ai
security:
  - BearerAuth: []
tags:
  - name: Simulations
    description: >-
      A simulation asks one or more user models questions (User Research) or
      sends their simulated users through a page or a flow (User Journey). It is
      planned first, then run once you have checked the plan.
  - name: Projects
    description: >-
      A project groups the simulations about one piece of work, split into
      rounds.
  - name: Rounds
    description: >-
      A round is one version of what you are testing: the document, page or file
      it tests, its simulations, and one synthesis across them.
  - name: Context
    description: >-
      Your context is the background on your company or product that every
      simulation is planned against.
  - name: User Models
    description: >-
      A user model is a simulated version of a specific group of people, built
      from real human data. Every simulation runs against one or more. A segment
      is a user model cut from another by its simulated users' attributes.
  - name: Simulation Schema
    description: >-
      The goals each kind of simulation offers, and what each goal needs from
      you.
paths:
  /v1/contexts:
    get:
      tags:
        - Context
      summary: List contexts
      description: >-
        List the written contexts you can plan against, yours and your

        organisation's, most recently updated first. Pass an id as context_id
        when

        creating a project or simulation to plan against it.
      operationId: list_contexts_route_v1_contexts_get
      parameters:
        - name: authorization
          in: header
          required: false
          schema:
            type: string
            title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

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