Integrations

REST API

Build custom integrations with the Pikarama API.

Getting Started

  1. Go to Settings in the Pikarama web app
  2. Scroll to "API Tokens" and click "Generate"
  3. Copy the token and store it securely

Authentication

Include your API token in the Authorization header of every request:

Authorization: Bearer pk_xxxxxxxxxxxx

Available Endpoints

GET/api/v1/groups

List all groups you are a member of

GET/api/v1/events

List active events (submitting/voting)

POST/api/v1/events

Create a new event in a topic

GET/api/v1/events/:id

Get event details, submissions, and results

POST/api/v1/events/:id/submit

Submit your pick or pass

POST/api/v1/events/:id/vote

Cast your vote for a submission

GET/api/v1/karma

Check your karma across all topics

Example Request

curl -H "Authorization: Bearer pk_xxx" \
  https://www.pikarama.com/api/v1/groups
Pikarama — Fair Group Decisions