---
title: "Request store access with a Cumulus barcode"
url: "https://developer-qual.migros.ch/apis/smart-entry-0/versions/2ca08bf1-64bb-4901-aa87-fd55e42d6351/operations/postBarcodeAuth"
---

> Full API specification: https://developer-qual.migros.ch/apis/smart-entry-0/versions/2ca08bf1-64bb-4901-aa87-fd55e42d6351.md

# Request store access with a Cumulus barcode

`POST` `/migros/customer/smart-entry/v1/auth/barcode`

Operation ID: `postBarcodeAuth`

Validates the barcode format and requests that the configured store door is opened.

## Request body (required)

Content types: `application/json`

## Responses

- `200` - Door request accepted
- `400` - Malformed request or invalid field
- `401` - Unauthorized
- `404` - Store or door not found
- `502` - Door controller rejected or could not process the request

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Smart Entry
  version: 0.9.0
servers:
  - description: URL of upstream service
    url: https://smart-entry.service.qual.migros.cloud
paths:
  /migros/customer/smart-entry/v1/auth/barcode:
    post:
      description: Validates the barcode format and requests that the configured store
        door is opened.
      operationId: postBarcodeAuth
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BarcodeAuthRequest"
        required: true
      responses:
        "200":
          description: Door request accepted
        "400":
          description: Malformed request or invalid field
        "401":
          description: Unauthorized
        "404":
          description: Store or door not found
        "502":
          description: Door controller rejected or could not process the request
      summary: Request store access with a Cumulus barcode
      tags:
        - smart-entry
security:
  - ApiKeyAuth: []
components:
  schemas:
    BarcodeAuthRequest:
      properties:
        barcode:
          description: 13-digit Cumulus barcode beginning with 2098 or 2099
          example: "2098123456789"
          type: string
        doorId:
          description: Configured door identifier
          example: "1"
          minLength: 1
          type: string
        storeId:
          description: Store identifier
          example: A16BCZ
          minLength: 1
          type: string
        trackingId:
          description: Request identifier forwarded unchanged to the door controller
          example: 04a2bebf-42c7-46b3-afb3-7ec0a4866703
          format: uuid
          type: string
      required:
        - storeId
        - doorId
        - trackingId
        - barcode
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: X-Api-Key
      type: apiKey
```