# View Cart

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/managers/store/abandoned-carts/{cart-id}:
    get:
      summary: View Cart
      deprecated: false
      description: >
        This endpoint fetches comprehensive details about an abandoned cart,
        identified

        by its unique ID. An abandoned cart is a shopping cart to which items
        have been added 

        but is left incomplete by the customer. A cart is marked as abandoned
        after

        **10 minutes** of inactivity.


        Along with detailed information about the cart and its contents, this
        endpoint provides 

        the `url` field, which is the direct link to the abandoned cart. This
        enables merchants 

        to easily **retarget** customers with a direct link to their uncompleted
        purchase, 

        enhancing the chances of converting these abandoned carts into completed
        transactions.


        The response also includes the customer's name and contact details,
        providing additional context 

        for retargeting efforts and potential follow-up communications.


        The response conforms to the Abandoned Cart schema, providing
        comprehensive details 

        of the cart, its associated customer, and the products within it.


        <Accordion title="🔑Scopes" defaultOpen>
            
        `abandoned_carts.read` - Abandoned Carts Read
         
        </Accordion>
      operationId: get-abandoned-cart
      tags:
        - Default module/Apps/Merchant APIs/Abandoned Carts
        - Abandoned Carts
      parameters:
        - name: cart-id
          in: path
          description: ''
          required: true
          example: b978fcc2-ccd0-45f6-81a7-7ab1f3b8f85d
          schema:
            type: string
        - 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: >-
            This token is used to authenticate and access information related to
            the store. It is obtained through an OAuth mechanism and is required
            to perform operations on the store's data. The `X-Manager-Token`
            should be included in the header of API requests that require
            store-related information.
          required: false
          example: '{{Access-Token}}'
          schema:
            type: string
        - name: Accept-Language
          in: header
          description: >-
            Preferred language for the response. Defaults to `en` if not
            specified.
          required: false
          example: en
          schema:
            type: string
            enum:
              - en
              - ar
            examples:
              - en
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: Response wrapper type.
                    examples:
                      - object
                  abandoned_cart:
                    $ref: '#/components/schemas/ViewAbandonedCartSerializer'
                  message: &ref_0
                    $ref: '#/components/schemas/ResponseEnvelopMessage'
                required:
                  - status
                  - abandoned_cart
                  - message
                x-apidog-orders:
                  - status
                  - abandoned_cart
                  - message
                description: Response returned when retrieving abandoned carts.
                x-apidog-ignore-properties: []
              example:
                status: object
                abandoned_cart:
                  id: b978fcc2-ccd0-45f6-81a7-7ab1f3b8f85d
                  url: >-
                    https://osama.zid.store/checkout/fromBasket/3:694ff0d8df6032a7697a3849
                  store_id: d297fb8b-c322-412e-a2f4-ffa96dc57022
                  store_name: متجر أسامة.
                  store_logo: >-
                    https://media.zid.store/d297fb8b-c322-412e-a2f4-ffa96dc57022/0e959ed7-ced5-47df-b839-16969940db08-200x.jpg
                  store_url: https://osama.zid.store/
                  products_count: 1
                  products:
                    - id: 1048562914
                      product_id: b2dd7116dd724f7fb10cac7e85b34655
                      product_url: >-
                        https://osama.zid.store/products/b2dd7116dd724f7fb10cac7e85b34655
                      sku: Z.17639724523193033
                      name: Test recurring
                      custom_field: []
                      price: 38.0182984840272
                      price_string: 38.02 ج.م
                      additions_price: 0
                      additions_price_string: 0.00 ج.م
                      quantity: 1
                      total: 38.0182984840272
                      total_string: 38.02 ج.م
                      images:
                        - id: 9fa5ece1-5c33-486f-97b1-bdd1f1b7770d
                          origin: >-
                            https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/9fa5ece1-5c33-486f-97b1-bdd1f1b7770d-thumbnail-500x500.png
                          thumbs:
                            fullSize: >-
                              https://media.zid.store/d297fb8b-c322-412e-a2f4-ffa96dc57022/9fa5ece1-5c33-486f-97b1-bdd1f1b7770d.png
                            thumbnail: >-
                              https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/9fa5ece1-5c33-486f-97b1-bdd1f1b7770d-thumbnail-370x370.png
                            small: >-
                              https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/9fa5ece1-5c33-486f-97b1-bdd1f1b7770d-thumbnail-500x500.png
                            medium: >-
                              https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/9fa5ece1-5c33-486f-97b1-bdd1f1b7770d-thumbnail-770x770.png
                            large: >-
                              https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/9fa5ece1-5c33-486f-97b1-bdd1f1b7770d-thumbnail-1000x1000.png
                  city:
                    id: 5354
                    national_id: null
                    name: Assuit
                    priority: 0
                    country_id: 63
                    country_name: Egypt
                    country_code: EG
                    ar_name: أسيوط
                    en_name: Assuit
                  order_id: null
                  history:
                    - uuid: 23e4394c-2048-4a68-b95c-8310058c7d0f
                      abandoned_cart_id: b978fcc2-ccd0-45f6-81a7-7ab1f3b8f85d
                      type: Created Successfully
                      created_at: '2025-12-27T14:53:32.000000Z'
                      updated_at: '2025-12-27T14:53:32.000000Z'
                    - uuid: 6ffa538f-5be0-49f7-8e90-06c4b405b522
                      abandoned_cart_id: b978fcc2-ccd0-45f6-81a7-7ab1f3b8f85d
                      type: Reminder Sent
                      created_at: '2025-12-28T14:53:39.000000Z'
                      updated_at: '2025-12-28T14:53:39.000000Z'
                    - uuid: ec62449e-fac5-4837-b640-32e94435f9d8
                      abandoned_cart_id: b978fcc2-ccd0-45f6-81a7-7ab1f3b8f85d
                      type: Reminder Sent
                      created_at: '2025-12-27T15:53:27.000000Z'
                      updated_at: '2025-12-27T15:53:27.000000Z'
                  phase: payment_method
                  customer_id: 15141670
                  customer_name: mahmoud aaaa
                  customer_email: a.alkallas@zid.sa
                  customer_mobile: '966500000005'
                  reminders_count: 2
                  cart_total: 509.8254
                  cart_total_string: 509.83 ج.م
                  whatsapp_message: Hello What'sapp
                  created_at: '2025-12-27 14:45:44'
                  updated_at: '2025-12-28 14:53:39'
                  source: catalog
                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:
                '3':
                  summary: Example 1
                  value:
                    status: error
                    message:
                      type: error
                      code: ERROR_SESSION_MISSING
                      name: Sorry
                      description: Please login first.
                '4':
                  summary: Example 2
                  value:
                    status: error
                    message:
                      type: error
                      code: ERROR_SESSION_INVALID
                      name: Sorry
                      description: Login session expired. Please login again.
                '5':
                  summary: Example 3
                  value:
                    status: error
                    message:
                      type: error
                      code: ERROR_SESSION_INVALID
                      name: Sorry
                      description: Invalid authentication
          headers: {}
          x-apidog-name: Unauthorized
        '422':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  message: *ref_0
                required:
                  - status
                  - message
                x-apidog-orders:
                  - status
                  - message
                x-apidog-ignore-properties: []
              example:
                status: validation_error
                message:
                  type: validation_errors
                  code: ERROR_POPUP_OK
                  name: Inputs
                  description: Input errors!
                  validations:
                    - field: id
                      errors:
                        - The selected id is invalid.
          headers: {}
          x-apidog-name: Validation errors
        '500':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: Status of the error.
                  message: *ref_0
                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/Abandoned Carts
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/613905/apis/api-9148591-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: ''
    ViewAbandonedCartSerializer:
      type: object
      properties:
        id:
          type: string
        url:
          type: string
        store_id:
          type: string
        store_name:
          type: string
        store_logo:
          type: string
        store_url:
          type: string
        products_count:
          type: integer
        products:
          type: array
          items:
            $ref: '#/components/schemas/DefaultAbandonedCartProductSerializer'
        city:
          $ref: '#/components/schemas/CityPresenter'
        order_id:
          type: integer
          nullable: true
        history:
          type: array
          items:
            $ref: '#/components/schemas/AbandonedCartHistoryPresenter'
        phase:
          type: string
          enum:
            - new
            - login
            - shipping_address
            - shipping_method
            - payment_method
            - verification
            - completed
          x-apidog-enum:
            - value: new
              name: ''
              description: ''
            - value: login
              name: ''
              description: ''
            - value: shipping_address
              name: ''
              description: ''
            - value: shipping_method
              name: ''
              description: ''
            - value: payment_method
              name: ''
              description: ''
            - value: verification
              name: ''
              description: ''
            - value: completed
              name: ''
              description: ''
        customer_id:
          type: integer
        customer_name:
          type: string
        customer_email:
          type: string
          nullable: true
        customer_mobile:
          type: string
          nullable: true
        reminders_count:
          type: integer
        cart_total:
          type: number
        cart_total_string:
          type: string
        whatsapp_message:
          type: string
        source:
          type: string
          enum:
            - api
            - mobile_app
            - catalog
            - pos
            - mazeed
            - md
            - mazeed_marketplace
            - mazeed_channels
          x-apidog-enum:
            - value: api
              name: ''
              description: ''
            - value: mobile_app
              name: ''
              description: ''
            - value: catalog
              name: ''
              description: ''
            - value: pos
              name: ''
              description: ''
            - value: mazeed
              name: ''
              description: ''
            - value: md
              name: ''
              description: ''
            - value: mazeed_marketplace
              name: ''
              description: ''
            - value: mazeed_channels
              name: ''
              description: ''
        created_at:
          type: string
        updated_at:
          type: string
      required:
        - id
        - url
        - store_id
        - store_name
        - store_logo
        - store_url
        - products_count
        - products
        - city
        - order_id
        - history
        - phase
        - customer_id
        - customer_name
        - customer_email
        - customer_mobile
        - reminders_count
        - cart_total
        - cart_total_string
        - whatsapp_message
        - source
        - created_at
        - updated_at
      x-apidog-orders:
        - id
        - url
        - store_id
        - store_name
        - store_logo
        - store_url
        - products_count
        - products
        - city
        - order_id
        - history
        - phase
        - customer_id
        - customer_name
        - customer_email
        - customer_mobile
        - reminders_count
        - cart_total
        - cart_total_string
        - whatsapp_message
        - source
        - created_at
        - updated_at
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    AbandonedCartHistoryPresenter:
      type: object
      properties:
        uuid:
          type: string
        abandoned_cart_id:
          type: string
        type:
          type: string
        created_at:
          type: string
        updated_at:
          type: string
      required:
        - uuid
        - abandoned_cart_id
        - type
        - created_at
        - updated_at
      x-apidog-orders:
        - uuid
        - abandoned_cart_id
        - type
        - created_at
        - updated_at
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    CityPresenter:
      type: object
      properties:
        name:
          type: string
          description: >-
            Name of the city, written in the language specified by the
            _Accept-Language_ header parameter; defaults to Arabic if
            _Accept-Language_ is not specified. (Always "Other" if
            is_marketplace_order is true)
          examples:
            - Other
        id:
          type: integer
          description: Unique identifier of the city
          examples:
            - 1
        national_id:
          type: integer
          description: National identifier of the city.
          examples:
            - 3
          nullable: true
        priority:
          type: integer
          description: Priority of the city. Higher number indicates higher priority.
          examples:
            - 10
        country_id:
          type: integer
          description: Unique identifier of the country the city is located in
          examples:
            - 184
        country_name:
          type: string
          description: Name of the country the city is located in (in Arabic)
          examples:
            - السعودية
          nullable: true
        country_code:
          type: string
          description: Two-letter country code according to ISO 3166-1 alpha-2
          examples:
            - SA
          nullable: true
        ar_name:
          type: string
          description: Name of the city in Arabic
          examples:
            - الرياض
        en_name:
          type: string
          description: Name of the city in English
          examples:
            - Riyadh
      required:
        - name
        - id
        - priority
        - country_id
        - country_name
        - country_code
        - ar_name
        - en_name
      x-stoplight:
        id: 58nkno2i3bgh0
      x-apidog-orders:
        - name
        - id
        - national_id
        - priority
        - country_id
        - country_name
        - country_code
        - ar_name
        - en_name
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    DefaultAbandonedCartProductSerializer:
      type: object
      properties:
        id:
          anyOf:
            - type: integer
            - type: string
        product_id:
          type: string
        product_url:
          type: string
        sku:
          type: string
        name:
          type: string
        custom_field:
          type: array
          items:
            $ref: '#/components/schemas/ProductCustomFieldsSerializer'
        price:
          type: number
        price_string:
          type: string
        additions_price:
          type: number
        additions_price_string:
          type: string
        quantity:
          type: integer
        total:
          type: number
        total_string:
          type: string
        images:
          type: array
          items:
            $ref: '#/components/schemas/ProductImageObject'
      x-apidog-orders:
        - id
        - product_id
        - product_url
        - sku
        - name
        - custom_field
        - price
        - price_string
        - additions_price
        - additions_price_string
        - quantity
        - total
        - total_string
        - images
      required:
        - id
        - product_id
        - product_url
        - sku
        - name
        - custom_field
        - price
        - price_string
        - additions_price
        - additions_price_string
        - quantity
        - total
        - total_string
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    ProductImageObject:
      type: object
      properties:
        id:
          type: string
        origin:
          type: string
        thumbs:
          type: object
          properties:
            fullSize:
              type: string
            thumbnail:
              type: string
            small:
              type: string
            medium:
              type: string
            large:
              type: string
          required:
            - fullSize
            - thumbnail
            - small
            - medium
            - large
          x-apidog-orders:
            - fullSize
            - thumbnail
            - small
            - medium
            - large
          x-apidog-ignore-properties: []
      required:
        - id
        - origin
        - thumbs
      x-apidog-orders:
        - id
        - origin
        - thumbs
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    ProductCustomFieldsSerializer:
      type: object
      properties:
        type:
          type: string
          description: >-
            Defines the data type of the custom field value. This determines how
            the value should be interpreted and displayed.
        value:
          type: string
          description: >-
            Raw value of the custom field as stored in the system. This value is
            typically unformatted and should be used for logic or processing.
        formatted_value:
          type: string
          description: >-
            Human-readable version of the value, formatted for display in UI.
            May include localization, labels, or formatting applied based on the
            field type.

            Example:
        name:
          type: string
          description: >-
            Internal name or key of the custom field. Used for system-level
            identification and integrations.
          nullable: true
        label:
          type: string
          description: Display label of the custom field shown to end users.
          nullable: true
      x-apidog-orders:
        - type
        - value
        - formatted_value
        - name
        - label
      required:
        - type
        - value
        - formatted_value
        - name
        - label
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://api.zid.sa/
    description: Prod Env
security: []

```