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

# Get account and pharmacies

> Returns the integration account of this key and its pharmacies. For each pharmacy, the response contains the scopes of the key and the courier booking setting. Use this endpoint to test the connection.



## OpenAPI

````yaml /openapi.yaml get /me
openapi: 3.1.0
info:
  title: GO JOE Pharmacy API
  version: 1.0.0-prototype
  summary: >-
    Receive GO JOE orders in your ERP, report their status, and send stock and
    prices to GO JOE.
  description: |
    With the GO JOE Pharmacy API, a pharmacy or the ERP of a pharmacy group
    receives paid, doctor-approved GO JOE orders and reports their status.

    **Order flow**

    1. GO JOE sends a signed **webhook** (`order.created`) to your endpoint.
    2. Your ERP fetches the order with `GET /orders/{id}` and downloads the
       prescription with `GET /orders/{id}/prescription`.
    3. Your ERP accepts the order with its own order number
       (`POST /orders/{id}/accept`).
    4. Your ERP reports the status: `packed`, `ready_for_pickup`,
       `out_for_delivery` or `completed` (`POST /orders/{id}/status`).

    The **event feed** (`GET /events`) contains every event for 30 days. Use it
    to process events whose webhook you did not receive.

    Send **stock and prices** with `PUT /pharmacies/{pharmacy_id}/inventory`
    (several articles) or `PATCH …/inventory/{pharmacy_sku}` (one article).

    **Prescription stages**

    An order is available as soon as the *Vorab-Rezept* exists
    (`prescription.stage` is `vorab`). This is the prescription before the
    doctor has applied the qualified electronic signature (QES). When the
    doctor has signed, you receive `order.prescription_signed`. Download the
    document again and replace the Vorab-Rezept with the signed version.

    **Conventions**

    - Requests and responses are JSON in UTF-8.
    - Timestamps are ISO 8601 in UTC.
    - Amounts are integers in euro cents, including VAT.
    - Quantities are in grams (flower) or millilitres (extracts).
    - GO JOE can add response fields and event types without a new API
      version. Ignore fields and types that your ERP does not know.
    - Errors are `application/problem+json` with a `code` that does not change.
      The [error reference](https://developers.gojoe.de/guides/errors) lists
      all codes.
  contact:
    name: GO JOE Integrations
    email: support@gojoe.de
servers:
  - url: https://gojoe.de/api/pharm/v1
    description: Production (live keys, gj_live_…).
  - url: https://sandbox-api.gojoe.de/api/pharm/v1
    description: >-
      Sandbox (test keys, gj_test_…). Contains test orders and MUSTER
      prescriptions only.
security:
  - apiKey: []
tags:
  - name: Account
  - name: Orders
  - name: Events
  - name: Inventory
  - name: Webhooks
    description: The request that GO JOE sends to your webhook URL.
  - name: Sandbox
    description: >-
      Simulator endpoints. They exist in the sandbox only. In production they
      return 404.
paths:
  /me:
    get:
      tags:
        - Account
      summary: Get account and pharmacies
      description: >-
        Returns the integration account of this key and its pharmacies. For each
        pharmacy, the response contains the scopes of the key and the courier
        booking setting. Use this endpoint to test the connection.
      operationId: getMe
      responses:
        '200':
          description: Account and pharmacies
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Me'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    Me:
      type: object
      properties:
        account:
          type: object
          properties:
            id:
              type: string
              format: uuid
            name:
              type:
                - string
                - 'null'
        environment:
          type: string
          enum:
            - live
            - sandbox
        pharmacies:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                format: uuid
              name:
                type:
                  - string
                  - 'null'
              city:
                type:
                  - string
                  - 'null'
              scopes:
                type: array
                description: >-
                  The scopes of this key for the pharmacy. `inventory:write`
                  also allows `GET /inventory`.
                items:
                  type: string
                  enum:
                    - orders:read
                    - orders:write
                    - prescriptions:read
                    - inventory:write
              courier_booking:
                type: string
                enum:
                  - on_packed
                  - manual
                description: >
                  How the courier for express orders is booked. `on_packed`: GO
                  JOE

                  books the courier when you report `packed`. `manual`: pharmacy

                  staff book the courier in the GO JOE dashboard.
    Problem:
      type: object
      required:
        - status
        - code
        - detail
        - request_id
      properties:
        type:
          type: string
          format: uri
          description: >-
            A link to this code in the error reference:
            `https://developers.gojoe.de/guides/errors#<code>`.
        title:
          type: string
        status:
          type: integer
        code:
          type: string
          example: invalid_transition
          description: >
            The error code, for example `unauthorized`, `not_accepted` or

            `invalid_transition`. Codes do not change. The

            [error reference](https://developers.gojoe.de/guides/errors) lists
            all codes.
        detail:
          type: string
        request_id:
          type: string
          description: Identifies the request. Include it when you contact GO JOE.
  responses:
    Unauthorized:
      description: >-
        The key is missing, unknown or revoked, or it belongs to the other
        environment
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    RateLimited:
      description: >-
        The account sent more requests than its limit allows. The default is 120
        requests per minute.
      headers:
        Retry-After:
          schema:
            type: integer
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        Send your key in the `Authorization` header: `Bearer gj_live_…` in
        production, `Bearer gj_test_…` in the sandbox.

````

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