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

# List Issues

> ListIssues returns a list of all the Issues for the given organisation.
The issues can be filtered by status, assignee, and other parameters.
Before and After query parameters refer to the createdAt timestamp of the issue.




## OpenAPI

````yaml /openapi/platform-api.yaml get /o/{organisation_id}/issues
openapi: 3.1.0
info:
  title: Versori Platform API
  version: 0.0.1
  license:
    name: UNLICENSED
servers:
  - description: Production
    url: https://platform.versori.com/api/v2
  - description: Staging
    url: https://platform-staging.versori.com/api/v2
  - description: Development
    url: http://localhost:8901
security:
  - bearerToken: []
  - cookie: []
paths:
  /o/{organisation_id}/issues:
    parameters:
      - $ref: '#/components/parameters/organisation_id'
    get:
      tags:
        - issues
      summary: List Issues
      description: >
        ListIssues returns a list of all the Issues for the given organisation.

        The issues can be filtered by status, assignee, and other parameters.

        Before and After query parameters refer to the createdAt timestamp of
        the issue.
      operationId: ListIssues
      parameters:
        - $ref: '#/components/parameters/first'
        - $ref: '#/components/parameters/after'
        - $ref: '#/components/parameters/before'
        - name: search_date
          in: query
          description: >
            Which date to use in after and before queries. If not provided,
            defaults to createdAt.

            The result will also be ordered by this date.
          schema:
            type: string
            enum:
              - createdAt
              - lastSeenAt
        - name: status
          in: query
          description: >
            Filter issues by status. Can be one of 'open', 'closed', 'acked' or
            'resolved'.

            If not provided, defaults to getting issues of all statuses.
          schema:
            $ref: '#/components/schemas/IssueStatusEnum'
        - name: project_id
          in: query
          description: >
            Filter issues by project ID. If not provided, issues from all
            projects are returned.

            This is useful for filtering issues related to a specific project.
          schema:
            type: string
        - name: environment_id
          in: query
          description: >
            Filter issues by environment ID. If not provided, issues from all
            projects are returned.

            This is useful for filtering issues related to a specific
            environment.
          schema:
            type: string
        - name: severity
          in: query
          description: |
            Filter issues by severity. Can be one of 'low', 'medium', or 'high'.
            If not provided, issues of all severities are returned.
          schema:
            $ref: '#/components/schemas/IssueSeverityEnum'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Issue'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    organisation_id:
      name: organisation_id
      in: path
      required: true
      schema:
        type: string
        format: ulid
        x-go-type: ulid.ULID
        x-go-name: OrganisationID
        x-go-type-import:
          path: versori.dev/vergo/ulid
    first:
      name: first
      in: query
      required: false
      schema:
        type: integer
        default: 20
    after:
      name: after
      in: query
      required: false
      schema:
        type: string
    before:
      name: before
      in: query
      required: false
      schema:
        type: string
  schemas:
    IssueStatusEnum:
      type: string
      enum:
        - open
        - closed
        - acked
        - resolved
      description: Current status of the issue
    IssueSeverityEnum:
      type: string
      enum:
        - high
        - low
        - medium
      description: Severity level of the issue
    Issue:
      type: object
      required:
        - id
        - organisationId
        - projectId
        - environmentId
        - status
        - reason
        - message
        - title
        - labels
        - annotations
        - duplication
        - createdAt
        - lastSeenAt
        - seenCount
      properties:
        id:
          type: string
          description: Unique identifier for the issue (ULID)
          x-go-type: ulid.ULID
          x-go-type-import:
            path: versori.dev/vergo/ulid
          x-go-type-skip-optional-pointer: true
        organisationId:
          type: string
          description: ID of the organization the isszue belongs to
          x-go-type: ulid.ULID
          x-go-type-import:
            path: versori.dev/vergo/ulid
          x-go-type-skip-optional-pointer: true
        projectId:
          type: string
          description: ID of the project the issue belongs to
          x-go-type: ulid.ULID
          x-go-type-import:
            path: versori.dev/vergo/ulid
          x-go-type-skip-optional-pointer: true
        environmentId:
          type: string
          description: ID of the environment the issue occurred in
          x-go-type: ulid.ULID
          x-go-type-import:
            path: versori.dev/vergo/ulid
          x-go-type-skip-optional-pointer: true
        status:
          $ref: '#/components/schemas/IssueStatusEnum'
        reason:
          $ref: '#/components/schemas/IssueReasonEnum'
        message:
          type: string
          description: Detailed message of the issue
        title:
          type: string
          description: Title of the issue
        labels:
          type: object
          description: Key-value pairs for searchable labels
          additionalProperties:
            type: string
          x-go-type-skip-optional-pointer: true
        annotations:
          type: object
          description: Key-value pairs for additional non-searchable information
          additionalProperties:
            type: string
          x-go-type-skip-optional-pointer: true
        resolutionStatus:
          $ref: '#/components/schemas/IssueResolutionStatusEnum'
        createdAt:
          type: string
          format: date-time
          description: Timestamp when the issue was created
        resolvedAt:
          type: string
          format: date-time
          nullable: true
          description: Timestamp when the issue was resolved
        lastSeenAt:
          type: string
          format: date-time
          description: Timestamp when the issue was last seen
        seenCount:
          type: integer
          description: Number of times the issue has been seen
        severity:
          $ref: '#/components/schemas/IssueSeverityEnum'
    Error:
      type: object
      properties:
        code:
          type: string
          description: Code is a machine-readable error code.
        message:
          type: string
          description: Message is a human-readable error message.
        fields:
          type: array
          items:
            $ref: '#/components/schemas/ErrorField'
          x-go-type-skip-optional-pointer: true
        details:
          type: string
          x-go-type-skip-optional-pointer: true
      required:
        - code
        - message
    IssueReasonEnum:
      type: string
      enum:
        - error
        - manual
      description: Reason for the issue creation
    IssueResolutionStatusEnum:
      type: string
      enum:
        - resolved
        - negated
        - ignored
      description: Status of the issue resolution
    ErrorField:
      description: ErrorField denotes a field which has an error.
      type: object
      properties:
        field:
          type: string
          description: >
            Field is the name of the field which has an error, this may be a
            path to a nested field, including array

            elements. The format of this field is of the form:
            "field1.field2[0].field3"
        message:
          type: string
          description: Message is the error message for this specific field.
      required:
        - field
        - message
  securitySchemes:
    bearerToken:
      description: >
        Bearer token authentication used by the Versori Platform. External
        consumers must provide an API key, however

        internal consumers must provide a JWT id_token issued by our IdP.
      type: http
      scheme: bearer
    cookie:
      description: Cookie authentication used by the Versori Platform.
      type: apiKey
      in: cookie
      name: cookie

````