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

# Get Campaign



## OpenAPI

````yaml /api_docs/openapi.yaml get /v1/server/campaigns/{id}
openapi: 3.0.3
info:
  title: PlayCamp SDK API
  description: >
    PlayCamp SDK API - Game analytics and creator campaign integration API


    ## Required Integration APIs (Server API)

    3 APIs that must be integrated for campaign operation:

    - `POST /v1/server/sponsors` - User boosts a creator

    - `POST /v1/server/coupons/validate` - Validate coupon code

    - `POST /v1/server/payments` - Register in-game payment


    ## Authentication

    - **Client API**: `Authorization: Bearer {CLIENT_KEY_ID}:{CLIENT_SECRET}`

    - **Server API**: `Authorization: Bearer {SERVER_KEY_ID}:{SERVER_SECRET}`


    ## Servers

    - **Live**: https://sdk-api.playcamp.io (Production data)

    - **Sandbox**: https://sandbox-sdk-api.playcamp.io (Test data)


    ## Key Types

    - **Client Key**: For game client (read-only - campaign, creator queries)

    - **Server Key**: For game server (read/write - coupon redemption, payment
    registration, etc.)


    ## Test Mode (isTest)

    Before campaign launch, use `isTest: true` parameter to test API
    integration.

    - Request parameter validation is performed identically to production

    - Returns mock data without recording to actual DB

    - Verify integration in Sandbox environment before campaign launch, then
    remove `isTest` parameter for actual campaign
  version: 1.1.0
  contact:
    name: PlayCamp Support
servers:
  - url: https://sdk-api.playcamp.io
    description: Live Server
  - url: https://sandbox-sdk-api.playcamp.io
    description: Sandbox Server
  - url: http://localhost:3001
    description: Local Live Server
  - url: http://localhost:3003
    description: Local Sandbox Server
security: []
tags:
  - name: Health
    description: Server health check
  - name: Client Campaign
    description: Campaign queries (Client API)
  - name: Client Creator
    description: Creator queries (Client API)
  - name: Client Coupon
    description: Coupon validation (Client API)
  - name: Client Sponsor
    description: Boost status queries — Sponsor API (Client API)
  - name: Server Campaign
    description: Campaign queries (Server API)
  - name: Server Creator
    description: Creator queries (Server API)
  - name: Server Coupon
    description: Coupon management (Server API)
  - name: Server Sponsor
    description: Boost management — Sponsor API (Server API)
  - name: Server Payment
    description: Payment management (Server API)
  - name: Server Playtime
    description: Playtime session management (Server API)
  - name: Server Webhook
    description: Webhook management (Server API)
  - name: Server Webview
    description: WebView management (Server API)
paths:
  /v1/server/campaigns/{id}:
    get:
      tags:
        - Server Campaign
      summary: Get Campaign
      operationId: serverGetCampaign
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/Campaign'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
        - ServerAuth: []
components:
  schemas:
    Campaign:
      type: object
      properties:
        campaignId:
          type: string
        projectId:
          type: string
        campaignName:
          type: object
          description: >-
            Multilingual campaign name (e.g., {"ko": "캠페인명", "en": "Campaign
            Name"})
          additionalProperties:
            type: string
        description:
          type: object
          description: Multilingual description
          additionalProperties:
            type: string
        startDate:
          type: string
          format: date-time
          nullable: true
        endDate:
          type: string
          format: date-time
          nullable: true
        status:
          type: string
          enum:
            - PENDING_EXPOSURE
            - EXPOSED
            - IN_PROGRESS
            - COMPLETED
            - CANCELLED
    Error:
      type: object
      required:
        - status
        - error
        - message
        - code
      properties:
        status:
          type: integer
          description: HTTP status code
        error:
          type: string
          description: HTTP status name
        message:
          type: string
          description: Detailed error message
        code:
          type: string
          description: |
            Error codes:
            - `VALIDATION_ERROR`: Request parameter validation failed
            - `BAD_REQUEST`: Invalid request
            - `UNAUTHORIZED`: Authentication failed (API key error)
            - `FORBIDDEN`: Access denied
            - `NOT_FOUND`: Resource not found
            - `CONFLICT`: Duplicate resource (already exists)
            - `INTERNAL_ERROR`: Internal server error
        details:
          type: array
          description: Validation error details (for VALIDATION_ERROR)
          items:
            type: object
            properties:
              path:
                type: string
              message:
                type: string
      example:
        status: 404
        error: Not Found
        message: 'Payment not found: txn-12345'
        code: NOT_FOUND
  responses:
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            status: 404
            error: Not Found
            message: Resource not found
            code: NOT_FOUND
  securitySchemes:
    ServerAuth:
      type: http
      scheme: bearer
      description: 'Server API Key (format: {keyId}:{secret})'

````