Luma Miscellaneous API
The Miscellaneous API from Luma — 3 operation(s) for miscellaneous.
OpenAPI Specification
openapi: 3.1.0
info:
title: Luma Calendars Miscellaneous API
version: 1.0.0
description: 'API for interacting with Luma''s event platform.
## Rate Limits
The Luma API uses a per-minute rate limit shared across `GET` and `POST` requests:
- **Calendar API keys** and OAuth tokens: **200 requests/minute** per calendar.
- **Organization API keys**: **500 requests/minute** per organization.
When you exceed the limit the API returns `429 Too Many Requests`. Back off before retrying.'
contact:
name: Luma Support
url: https://help.luma.com
license:
name: Proprietary
servers:
- url: https://public-api.luma.com
description: Production server
security:
- apiKeyAuth: []
tags:
- name: Miscellaneous
paths:
/v1/users/get-self:
get:
tags:
- Miscellaneous
summary: Get Self
parameters: []
responses:
'200':
description: Successful response.
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
id:
type: string
name:
anyOf:
- type: string
- type: 'null'
avatar_url:
type: string
email:
type: string
first_name:
anyOf:
- type: string
- type: 'null'
last_name:
anyOf:
- type: string
- type: 'null'
required:
- id
- name
- avatar_url
- email
- first_name
- last_name
/v1/entity/lookup:
get:
tags:
- Miscellaneous
summary: Lookup Entity
parameters:
- name: slug
in: query
required: true
schema:
type: string
description: Lookup an entity on Luma by it's slug.
responses:
'200':
description: Successful response.
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
entity:
anyOf:
- oneOf:
- type: object
properties:
type:
type: string
const: calendar
calendar:
type: object
properties:
id:
type: string
api_id:
type: string
deprecated: true
description: Use `id` instead.
name:
type: string
slug:
anyOf:
- type: string
- type: 'null'
avatar_url:
anyOf:
- type: string
- type: 'null'
required:
- id
- api_id
- name
- slug
required:
- type
- calendar
- type: object
properties:
type:
type: string
const: event
event:
type: object
properties:
id:
type: string
api_id:
type: string
deprecated: true
description: Use `id` instead.
name:
type: string
slug:
type: string
cover_url:
type: string
start_at:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
description: ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z
end_at:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
description: ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z
required:
- id
- api_id
- name
- slug
- cover_url
- start_at
- end_at
required:
- type
- event
- type: 'null'
required:
- entity
/v1/images/create-upload-url:
post:
tags:
- Miscellaneous
summary: Create Upload URL
requestBody:
required: true
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
content_type:
anyOf:
- type: string
enum:
- image/jpeg
- image/png
- type: 'null'
responses:
'200':
description: Successful response.
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
upload_url:
type: string
description: You'll upload your image here using a PUT request.
file_url:
type: string
required:
- upload_url
- file_url
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-luma-api-key
description: API key to authenticate requests to the Luma API. Generate an API key on your Luma dashboard.