We try to version the API using dates to maintain a highly backwards compatible API. You can specify a version using the tally-version header, e.g. tally-version: 2025-02-01.

2025-05-30
v0.3.0

New endpoints

  • GET /forms/{formId}/questions
    Get form questions
  • GET /forms/{formId}/submissions/{submissionId}
    Get a specific form submission
  • GET /organizations/{organizationId}/users
    View organization users
  • DELETE /organizations/{organizationId}/users/{userId}
    Remove users from organization
  • GET /organizations/{organizationId}/invites
    View pending invites
  • POST /organizations/{organizationId}/invites
    Invite users to organization
  • DELETE /organizations/{organizationId}/invites/{inviteId}
    Cancel pending invites
  • GET /webhooks
    List configured webhooks
  • GET /webhooks/{webhookId}/events
    List webhook events
  • POST /webhooks/{webhookId}/events/{eventId}
    Retry webhook events

Changed endpoints

  • GET /forms/{formId}/submissions
    Added new filtering options: startDate, endDate & afterId
2025-02-01
v0.2.0

New endpoints

  • GET /users/me

Changed endpoints

  • GET /forms
    Now returns a paginated response instead of a flat list.
  • GET /workspaces
    Now returns a paginated response instead of a flat list.

Deprecated endpoints

  • GET /me
2025-01-15
v0.1.0

Hello world! 🎉