TrieOH
UniventsAPIBadges

Get a badge template

Fetches a single badge template. Requires an owner, admin, or staff role on the event.

GET/badges/{template_id}

Fetches a single badge template. Requires an owner, admin, or staff role on the event.

Authorization

bearerAuth
AuthorizationBearer <token>

JWT issued by IdentityX, signed with Ed25519

In: header

Path Parameters

template_id*string

Badge template ID.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/badges/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "code": 0,
  "message": "string",
  "error": {
    "code": "BAD_REQUEST",
    "message": "string",
    "fields": [
      {
        "field": "string",
        "message": "string"
      }
    ],
    "meta": {},
    "debug": {
      "raw_error": "string",
      "stack_trace": "string"
    }
  },
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 0,
    "has_next": true,
    "has_prev": true,
    "next_page": 0,
    "prev_page": 0
  },
  "timestamp": "2019-08-24T14:15:22Z",
  "module": "string",
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "edition_id": "aeda7fca-56fe-426a-8c37-1876faaaf005",
    "ticket_type_id": "eca4fbe0-9707-40d2-b5fb-9c6a9e458262",
    "origin": "staff",
    "name": "string",
    "design_data": {},
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "deleted_at": "2019-08-24T14:15:22Z"
  }
}
{
  "code": 0,
  "message": "string",
  "error": {
    "code": "BAD_REQUEST",
    "message": "string",
    "fields": [
      {
        "field": "string",
        "message": "string"
      }
    ],
    "meta": {},
    "debug": {
      "raw_error": "string",
      "stack_trace": "string"
    }
  },
  "timestamp": "2019-08-24T14:15:22Z",
  "module": "string"
}
{
  "code": 0,
  "message": "string",
  "error": {
    "code": "BAD_REQUEST",
    "message": "string",
    "fields": [
      {
        "field": "string",
        "message": "string"
      }
    ],
    "meta": {},
    "debug": {
      "raw_error": "string",
      "stack_trace": "string"
    }
  },
  "timestamp": "2019-08-24T14:15:22Z",
  "module": "string"
}
{
  "code": 0,
  "message": "string",
  "error": {
    "code": "BAD_REQUEST",
    "message": "string",
    "fields": [
      {
        "field": "string",
        "message": "string"
      }
    ],
    "meta": {},
    "debug": {
      "raw_error": "string",
      "stack_trace": "string"
    }
  },
  "timestamp": "2019-08-24T14:15:22Z",
  "module": "string"
}
{
  "code": 0,
  "message": "string",
  "error": {
    "code": "BAD_REQUEST",
    "message": "string",
    "fields": [
      {
        "field": "string",
        "message": "string"
      }
    ],
    "meta": {},
    "debug": {
      "raw_error": "string",
      "stack_trace": "string"
    }
  },
  "timestamp": "2019-08-24T14:15:22Z",
  "module": "string"
}

Create a badge template POST

Creates a badge template for the edition (design data is opaque JSON consumed by the badge renderer). Set origin to "staff" for the edition's staff-only design (ticket_type_id must be absent); at most one staff template per edition. The actor must be an owner or admin of the event.

Update a badge template PATCH

Updates a badge template's name and/or design data. The target ticket type and origin are immutable — move a template by deleting and recreating it. Designs are read live, so emissions re-render automatically; no emails are sent. The actor must be an owner or admin of the event.