# List Reverse Reasons

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/managers/store/reverse-orders/reasons:
    get:
      summary: List Reverse Reasons
      deprecated: false
      description: |-
        Retrieves a list of order reverse reasons for the store.

        <Accordion title="🔑Scopes" defaultOpen>
            
          `orders.read` - Orders Read
         
        </Accordion>
      operationId: get-managers-store-reverse-orders-reasons
      tags:
        - Default module/Apps/Merchant APIs/Reverse Orders
        - Reverse Orders
      parameters:
        - name: Authorization
          in: header
          description: >-
            The Authorization token is a unique key given to the third-party
            application (Partner) by Zid. It is used to authenticate the API
            requests made by the Partner application. The token verifies the
            partner's identity and ensures they have permission to access Zid's
            API but does not provide any specific user or store information. It
            should be included in the header of API requests when the partner
            application needs to access Zid's API.
          required: true
          example: '{{Autherization}}'
          schema:
            type: string
        - name: X-MANAGER-TOKEN
          in: header
          description: >-
            Unique manager token used to authorize requests at a manager level,
            specific to each partner.
          required: true
          example: '{{Access-Token}}'
          schema:
            type: string
        - name: Accept-Language
          in: header
          description: Language preference.
          required: true
          example: en
          schema:
            type: string
            default: ar
            enum:
              - ar
              - en
            x-apidog-enum:
              - value: ar
                name: ''
                description: ''
              - value: en
                name: ''
                description: ''
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  Example 1:
                    order-reverse-reasons:
                      - id: d0b88a0bdefa4d36aeed8bfe747d7d1f
                        name: Does not match the description
                properties:
                  order-reverse-reasons:
                    type: array
                    description: >-
                      An array containing objects that specify the reasons for
                      reversing an order:
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Unique identifier for the reverse reason.
                          examples:
                            - '"d0b88a0bdefa4d36aeed8bfe747d7d1f"'
                        name:
                          type: string
                          description: Description of the reverse reason.
                          examples:
                            - '"Does not match the description"'
                      x-apidog-orders:
                        - id
                        - name
                      x-apidog-ignore-properties: []
                  name:
                    type: string
                    x-stoplight:
                      id: n5inx8i49o9u2
                    description: >-
                      This parameter is used to filter and search for reasons
                      based on their name. If provided, the endpoint will return
                      reasons that match or contain the specified name. If
                      omitted or set to null, all reasons will be returned.
                    examples:
                      - '"damaged"'
                x-apidog-orders:
                  - order-reverse-reasons
                  - name
                x-apidog-ignore-properties: []
              example:
                status: object
                order_reverse_reasons:
                  - id: 1e99df02-fe5f-4bff-b305-2b32731f50bc
                    name: new reason
                  - id: 3a7112b2-6bda-431a-bfdf-62942610f308
                    name: hhfjhdfh
                  - id: 3f4d9d0f-a502-4d8a-bee4-fef91be8b185
                    name: test
                  - id: 460d7f3b-35e6-4c82-b8eb-2ec3627e4708
                    name: dndgn
                  - id: 658d82bd-f828-49f1-8a39-a77e207a0fa6
                    name: hello
                  - id: 8b46f9b5-d88f-4687-8df5-f91c7d0373ad
                    name: Does not match the description
                  - id: ebcfd40a-7c2f-4ed4-b30f-3fd142388ad7
                    name: Customer canceled
                  - id: f569c42a-c134-492b-a2f0-c0a561b02cf5
                    name: Product was broken
                message:
                  type: object
                  code: null
                  name: null
                  description: null
          headers: {}
          x-apidog-name: OK
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                description: >-
                  Response returned when the request cannot be authenticated
                  because the required credentials are missing, invalid, or
                  expired.
                properties:
                  status:
                    type: string
                    description: Indicates the overall status of the API response.
                    examples:
                      - error
                  message:
                    type: object
                    description: >-
                      Contains structured details explaining why the request
                      could not be authenticated.
                    properties:
                      type:
                        type: string
                        description: Indicates the category of the response message.
                        examples:
                          - error
                      code:
                        type: string
                        description: >-
                          A machine-readable code identifying the authentication
                          error. Returns null when no specific code is
                          available.
                        examples:
                          - UNAUTHORIZED
                        nullable: true
                      name:
                        type: string
                        description: >-
                          A short, human-readable title describing the
                          authentication error. Returns null when no title is
                          available.
                        examples:
                          - Unauthorized
                        nullable: true
                      description:
                        type: string
                        description: >-
                          A human-readable explanation of why the request could
                          not be authenticated. Returns null when no detailed
                          explanation is available.
                        examples:
                          - >-
                            Authentication credentials are missing, invalid, or
                            expired.
                        nullable: true
                    required:
                      - type
                      - code
                      - name
                      - description
                    x-apidog-orders:
                      - type
                      - code
                      - name
                      - description
                    x-apidog-ignore-properties: []
                required:
                  - status
                  - message
                x-apidog-orders:
                  - status
                  - message
                examples:
                  - status: error
                    message:
                      type: error
                      code: UNAUTHORIZED
                      name: Unauthorized
                      description: >-
                        Authentication credentials are missing, invalid, or
                        expired.
                x-apidog-ignore-properties: []
              examples:
                '2':
                  summary: Example 1
                  value:
                    status: error
                    message:
                      type: error
                      code: ERROR_SESSION_MISSING
                      name: Sorry
                      description: Please login first.
                '3':
                  summary: Example 2
                  value:
                    status: error
                    message:
                      type: error
                      code: ERROR_SESSION_INVALID
                      name: Sorry
                      description: Login session expired. Please login again.
                '4':
                  summary: Example 3
                  value:
                    status: error
                    message:
                      type: error
                      code: ERROR_SESSION_INVALID
                      name: Sorry
                      description: Invalid authentication
          headers: {}
          x-apidog-name: Unauthorized
        '500':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: Status of the error.
                  message:
                    $ref: '#/components/schemas/ResponseEnvelopMessage'
                required:
                  - status
                  - message
                x-apidog-orders:
                  - status
                  - message
                x-apidog-ignore-properties: []
              example:
                status: error
                message:
                  type: error
                  code: MSG_HIDDEN
                  name: Error
                  description: Internal Server Error
          headers: {}
          x-apidog-name: Internal Server error
      security: []
      x-apidog-folder: Default module/Apps/Merchant APIs/Reverse Orders
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/613905/apis/api-9148653-run
components:
  schemas:
    ResponseEnvelopMessage:
      type: object
      properties:
        type:
          type: string
          description: Type of response message returned by the API.
          examples:
            - success
        code:
          type: string
          description: Response code returned by the API, if available.
          examples:
            - MSG_POPUP_OK
          nullable: true
        name:
          type: string
          description: Name or title of the response message, if available.
          examples:
            - Coupons
          nullable: true
        description:
          type: string
          description: Detailed description of the response message, if available.
          examples:
            - Coupons created successfully
          nullable: true
      required:
        - type
        - code
        - name
        - description
      description: Additional response metadata.
      x-apidog-orders:
        - type
        - code
        - name
        - description
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://api.zid.sa/
    description: Prod Env
security: []

```
