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

# Pobierz pocztówkę

> Zwraca jedną z Twoich pocztówek. Pocztówka z drugiego trybu zwraca `404`. Wymaga uprawnienia `postcards:read`.



## OpenAPI

````yaml /openapi.yaml get /api/postcards/{id}
openapi: 3.1.0
info:
  title: Paperjoy API
  version: '2026-10-19'
  description: >-
    Twórz, podglądaj i śledź prawdziwe, ręcznie pisane pocztówki. Klucz API
    decyduje, czy żądanie działa w trybie testowym, czy live.
  termsOfService: https://paperjoy.co/regulamin
  license:
    name: Proprietary
    url: https://paperjoy.co/regulamin
servers:
  - url: https://paperjoy.co
security:
  - bearerAuth: []
tags:
  - name: Konto
    description: Uwierzytelnione konto i saldo kredytów.
  - name: Pocztówki
    description: Tworzenie, podgląd, lista i pobieranie pocztówek.
  - name: Podpisy
    description: Własne podpisy odręczne Twojej organizacji.
paths:
  /api/postcards/{id}:
    get:
      tags:
        - Pocztówki
      summary: Pobierz pocztówkę
      description: >-
        Zwraca jedną z Twoich pocztówek. Pocztówka z drugiego trybu zwraca
        `404`. Wymaga uprawnienia `postcards:read`.
      operationId: getPostcard
      parameters:
        - name: id
          in: path
          required: true
          description: ID pocztówki zwrócone przy jej tworzeniu.
          schema:
            type: string
            examples:
              - pc_MXP7a4Ni0c
      responses:
        '200':
          description: Pocztówka.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostcardResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    PostcardResponse:
      type: object
      required:
        - data
      properties:
        data:
          $ref: '#/components/schemas/Postcard'
    Postcard:
      type: object
      required:
        - id
        - test_mode
        - recipient
        - signature
        - signature_id
        - mistake
        - status
        - submitted_at
        - sent_at
        - created_at
        - updated_at
      properties:
        id:
          type: string
          examples:
            - pc_MXP7a4Ni0c
        test_mode:
          type: boolean
          description: >-
            `true` dla pocztówki testowej. Pocztówki testowe są darmowe i nigdy
            nie są pisane ani wysyłane.
        address:
          description: Adres dostawy. Może być `null` tylko w szkicu.
          oneOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
        recipient:
          oneOf:
            - $ref: '#/components/schemas/Recipient'
            - type: 'null'
        content:
          type:
            - string
            - 'null'
          maxLength: 300
          description: Treść kartki. Może być `null` tylko w szkicu.
        signature:
          type:
            - string
            - 'null'
          maxLength: 50
          description: Wpisany podpis albo `null`, gdy pocztówka używa własnego podpisu.
        signature_id:
          type:
            - string
            - 'null'
          description: Własny podpis użyty na pocztówce albo `null`.
          examples:
            - sig_ZeXOkSQjTp
        font_id:
          description: Pismo. Może być `null` tylko w szkicu.
          oneOf:
            - $ref: '#/components/schemas/FontId'
            - type: 'null'
        mistake:
          type: boolean
          description: >-
            Czy jedno słowo jest przekreślone i napisane ponownie, aby kartka
            wyglądała naturalnie.
        status:
          $ref: '#/components/schemas/PostcardStatus'
        submitted_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Moment złożenia zamówienia. `null`, dopóki pocztówka jest szkicem.
        sent_at:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Moment nadania pocztówki. `null`, dopóki status nie zmieni się na
            `sent`.
        created_at:
          type:
            - string
            - 'null'
          format: date-time
        updated_at:
          type:
            - string
            - 'null'
          format: date-time
    Error:
      type: object
      required:
        - message
      properties:
        message:
          type: string
    Address:
      type: object
      required:
        - line_1
        - postal_code
        - country
        - city
      properties:
        line_1:
          type: string
          maxLength: 255
          description: Ulica i numer budynku.
          examples:
            - ul. Marszałkowska 10
        line_2:
          type:
            - string
            - 'null'
          maxLength: 255
          description: Numer lokalu, piętro lub inna informacja.
          examples:
            - m. 4
        postal_code:
          type: string
          pattern: ^\d{2}-\d{3}$
          examples:
            - 00-001
        country:
          type: string
          enum:
            - PL
        city:
          type: string
          maxLength: 255
          examples:
            - Warszawa
    Recipient:
      type: object
      description: Podaj `first_name`, `company_name` albo oba pola.
      properties:
        prefix:
          type:
            - string
            - 'null'
          maxLength: 30
          examples:
            - Pani
        first_name:
          type:
            - string
            - 'null'
          maxLength: 255
        last_name:
          type:
            - string
            - 'null'
          maxLength: 255
        company_name:
          type:
            - string
            - 'null'
          maxLength: 255
    FontId:
      type: string
      enum:
        - font-1
        - font-2
      description: >-
        `font-1` to czytelne, zaokrąglone pismo (Standardowe). `font-2` to
        szybsze pismo łączone (Szybkie).
    PostcardStatus:
      type: string
      description: >-
        Etap realizacji pocztówki. Nieznane wartości traktuj jako „w
        realizacji”.
      enum:
        - draft
        - new
        - queued
        - rejected
        - pair_claimed
        - in_progress
        - pair_completed
        - sent
  responses:
    Unauthorized:
      description: Brak klucza API albo klucz jest nieprawidłowy, unieważniony lub wygasł.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: Unauthenticated.
    Forbidden:
      description: >-
        Klucz API nie ma wymaganego uprawnienia albo zasób należy do kogoś
        innego.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: This action is unauthorized.
    NotFound:
      description: Zasób nie istnieje albo należy do drugiego trybu.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: Not found.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Klucz API Paperjoy. Klucze z prefiksem `pj_test_` działają w trybie
        testowym, a z `pj_live_` w trybie live.

````

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