Brushfire Lookups API

The Lookups API from Brushfire — 6 operation(s) for lookups.

Operations 6

POST /lookups Submit email to look up and create magic link
GET /lookups/{lookupId} Get matching events for a lookup ID
GET /lookups/{lookupId}/events/{eventNumber} Get matching single event for a lookup ID and eventNumber
GET /lookups/{lookupId}/events/{eventNumber}/attendees Get attendees for the selected lookup ID and eventNumber. This optionally looks across groups and orders also
GET /lookups/{lookupId}/events/{eventNumber}/group Get group for the selected lookup ID and eventNumber
GET /lookups/{lookupId}/events/{eventNumber}/orders Get orders for the selected lookup ID and eventNumber

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/brushfire-lookups-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

brushfire-lookups-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: 'Brushfire API: Version 2025-07-22 AccessCodes Lookups API'
  version: '2025-07-22'
  description: 'The Brushfire REST API provides programmatic access to the Brushfire event ticketing and registration platform. It covers events, ticket types, sections and seats, attendees, orders, the shopping cart and checkout flow, groups, sessions and check-in, promotions and access codes, payment profiles, and webhooks (Hooks). Authenticate by sending your App Key (requested at https://developer.brushfire.com/key) in the Authorization header. The API is date-versioned: send the desired version in the api-version request header (for example, 2025-07-22). This document is the live specification published at api.brushfire.com/swagger.'
  contact:
    name: Brushfire Developers
    url: https://developer.brushfire.com
servers:
- url: https://api.brushfire.com
  description: Brushfire API (date-versioned via the api-version header)
tags:
- name: Lookups
paths:
  /lookups:
    post:
      tags:
      - Lookups
      summary: Submit email to look up and create magic link
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LookupCreateInput'
          text/json:
            schema:
              $ref: '#/components/schemas/LookupCreateInput'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/LookupCreateInput'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: boolean
            text/json:
              schema:
                type: boolean
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiModelError'
            text/json:
              schema:
                $ref: '#/components/schemas/ApiModelError'
      security:
      - apiKey: []
  /lookups/{lookupId}:
    get:
      tags:
      - Lookups
      summary: Get matching events for a lookup ID
      parameters:
      - name: lookupId
        in: path
        description: A Guid retrieved from performing a post to /
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupResultOutput'
            text/json:
              schema:
                $ref: '#/components/schemas/LookupResultOutput'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiModelError'
            text/json:
              schema:
                $ref: '#/components/schemas/ApiModelError'
      security:
      - apiKey: []
  /lookups/{lookupId}/events/{eventNumber}:
    get:
      tags:
      - Lookups
      summary: Get matching single event for a lookup ID and eventNumber
      parameters:
      - name: lookupId
        in: path
        description: A Guid retrieved from performing a post to /
        required: true
        schema:
          type: string
      - name: eventNumber
        in: path
        description: An integer representing a single event
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupResultOutput'
            text/json:
              schema:
                $ref: '#/components/schemas/LookupResultOutput'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiModelError'
            text/json:
              schema:
                $ref: '#/components/schemas/ApiModelError'
      security:
      - apiKey: []
  /lookups/{lookupId}/events/{eventNumber}/attendees:
    get:
      tags:
      - Lookups
      summary: Get attendees for the selected lookup ID and eventNumber. This optionally looks across groups and orders also
      parameters:
      - name: lookupId
        in: path
        description: A Guid retrieved from performing a post to /
        required: true
        schema:
          type: string
      - name: eventNumber
        in: path
        description: An integer representing a single event
        required: true
        schema:
          type: integer
          format: int64
      - name: includeGroups
        in: query
        description: Boolean to include group emails in search. Defaults to false.
        schema:
          type: boolean
          default: false
      - name: includeOrders
        in: query
        description: Boolean to include buyer emails in search. Defaults to false.
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/LookupAttendeeResultOutput'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/LookupAttendeeResultOutput'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiModelError'
            text/json:
              schema:
                $ref: '#/components/schemas/ApiModelError'
      security:
      - apiKey: []
  /lookups/{lookupId}/events/{eventNumber}/group:
    get:
      tags:
      - Lookups
      summary: Get group for the selected lookup ID and eventNumber
      parameters:
      - name: lookupId
        in: path
        description: A Guid retrieved from performing a post to /
        required: true
        schema:
          type: string
      - name: eventNumber
        in: path
        description: An integer representing a single event
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupGroupResultOutput'
            text/json:
              schema:
                $ref: '#/components/schemas/LookupGroupResultOutput'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiModelError'
            text/json:
              schema:
                $ref: '#/components/schemas/ApiModelError'
      security:
      - apiKey: []
  /lookups/{lookupId}/events/{eventNumber}/orders:
    get:
      tags:
      - Lookups
      summary: Get orders for the selected lookup ID and eventNumber
      parameters:
      - name: lookupId
        in: path
        description: A Guid retrieved from performing a post to /
        required: true
        schema:
          type: string
      - name: eventNumber
        in: path
        description: An integer representing a single event
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/LookupOrderResultOutput'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/LookupOrderResultOutput'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiModelError'
            text/json:
              schema:
                $ref: '#/components/schemas/ApiModelError'
      security:
      - apiKey: []
components:
  schemas:
    LookupAttendeeResultOutput:
      type: object
      properties:
        Id:
          type: string
          format: uuid
        AttendeeNumber:
          type: integer
          format: int64
        Status:
          type:
          - string
          - 'null'
        IsCompleted:
          type: boolean
        IsGift:
          type: boolean
        IsPreRegistered:
          type: boolean
        ShareEmail:
          type:
          - string
          - 'null'
        GiftingEnabled:
          type: boolean
        GiftLastSentAt:
          type:
          - string
          - 'null'
          format: date-time
        GiftLastSentAtLocal:
          type:
          - string
          - 'null'
          format: date-time
          readOnly: true
        TimeZoneId:
          type:
          - string
          - 'null'
        FirstName:
          type:
          - string
          - 'null'
        LastName:
          type:
          - string
          - 'null'
        Name:
          type:
          - string
          - 'null'
          readOnly: true
        AttendeeTypeId:
          type: string
          format: uuid
        TypeName:
          type:
          - string
          - 'null'
        TypeAmount:
          type: number
          format: double
        TypeDisplayAmount:
          type: number
          format: double
        SectionName:
          type:
          - string
          - 'null'
        RowName:
          type:
          - string
          - 'null'
        SeatLabel:
          type:
          - string
          - 'null'
        Amount:
          type: number
          format: double
        Addons:
          type: number
          format: double
        Discounts:
          type: number
          format: double
        SeatInfo:
          type:
          - string
          - 'null'
        Culture:
          type:
          - string
          - 'null'
        GroupId:
          type:
          - string
          - 'null'
          format: uuid
        GroupName:
          type:
          - string
          - 'null'
        GroupEmail:
          type:
          - string
          - 'null'
        AttendeeDisplay:
          $ref: '#/components/schemas/AttendeeDisplayOutput'
        AttendeeDisplayLines:
          $ref: '#/components/schemas/AttendeeDisplayOutput'
        DisplayPrice:
          type: number
          format: double
          readOnly: true
        DisplayTotal:
          type: number
          format: double
          readOnly: true
        PriceDescription:
          type:
          - string
          - 'null'
        HasPaymentsToMake:
          type: boolean
        DonatingBackEnabled:
          type: boolean
        ChangesAreBlocked:
          type: boolean
        ChangesAreBlockedAfter:
          type:
          - string
          - 'null'
          format: date-time
        HasPendingSignatures:
          type: boolean
        AllSignaturesComplete:
          type: boolean
        ShareEnabled:
          type: boolean
        TicketInfo:
          $ref: '#/components/schemas/TicketInfoOutput'
      additionalProperties: false
    FlexPassCheckinItem:
      type: object
      properties:
        EventId:
          type: string
          format: uuid
        EventNumber:
          type: integer
          format: int64
        Title:
          type:
          - string
          - 'null'
        CheckedInAt:
          type: string
          format: date-time
        SessionName:
          type:
          - string
          - 'null'
        AttendeeCheckinId:
          type: string
          format: uuid
        EventSessionId:
          type: string
          format: uuid
        SessionNumber:
          type: integer
          format: int64
        TimeZoneId:
          type:
          - string
          - 'null'
        CheckedInAtLocal:
          type: string
          format: date-time
          readOnly: true
        Culture:
          type:
          - string
          - 'null'
        Dates:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/EventDateItem'
        StartsAt:
          type:
          - string
          - 'null'
          format: date-time
          readOnly: true
        TitleInfo:
          type:
          - string
          - 'null'
          readOnly: true
      additionalProperties: false
    LookupOrderResultOutput:
      type: object
      properties:
        Id:
          type: string
          format: uuid
        OrderKey:
          type:
          - string
          - 'null'
        OrderedAt:
          type: string
          format: date-time
        OrderedAtLocal:
          type: string
          format: date-time
        TimeZoneId:
          type:
          - string
          - 'null'
        BillingName:
          type:
          - string
          - 'null'
        Amount:
          type: number
          format: double
        IsAdjustment:
          type: boolean
        Culture:
          type:
          - string
          - 'null'
        AttendeeCount:
          type: integer
          format: int32
      additionalProperties: false
    LookupEventResultOutput:
      type: object
      properties:
        Event:
          $ref: '#/components/schemas/EventListOutput'
        HasGroup:
          type: boolean
        HasOrders:
          type: boolean
        ShowAttendees:
          type: boolean
      additionalProperties: false
    TicketInfoOutput:
      type: object
      properties:
        AttendeeTypeName:
          type:
          - string
          - 'null'
        AttendeeName:
          type:
          - string
          - 'null'
        Title:
          type:
          - string
          - 'null'
        Section:
          type:
          - string
          - 'null'
        RowLabel:
          type:
          - string
          - 'null'
        Row:
          type:
          - string
          - 'null'
        Seat:
          type:
          - string
          - 'null'
        FlexSummary:
          type:
          - string
          - 'null'
        Field1Label:
          type:
          - string
          - 'null'
        Field1Value:
          type:
          - string
          - 'null'
        Field2Label:
          type:
          - string
          - 'null'
        Field2Value:
          type:
          - string
          - 'null'
        Field3Label:
          type:
          - string
          - 'null'
        Field3Value:
          type:
          - string
          - 'null'
        ImageUrl:
          type:
          - string
          - 'null'
        TicketRenderType:
          $ref: '#/components/schemas/TicketRenderType'
        TicketNotes:
          type:
          - string
          - 'null'
        TicketAd:
          type:
          - string
          - 'null'
        EventDate:
          type:
          - string
          - 'null'
        EventTime:
          type:
          - string
          - 'null'
        EventDoorTime:
          type:
          - string
          - 'null'
        EventTitle:
          type:
          - string
          - 'null'
        QrImageUrl:
          type:
          - string
          - 'null'
        QrText:
          type:
          - string
          - 'null'
        PassUrl:
          type:
          - string
          - 'null'
        WalletUrl:
          type:
          - string
          - 'null'
        BundledPassUrl:
          type:
          - string
          - 'null'
        BundledWalletUrl:
          type:
          - string
          - 'null'
        PrintUrl:
          type:
          - string
          - 'null'
        BundledPrintUrl:
          type:
          - string
          - 'null'
        EditUrl:
          type:
          - string
          - 'null'
        FlexPassRedemptionsUsed:
          type:
          - string
          - 'null'
        FlexPassRedemptions:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/FlexPassCheckinItem'
        IsFlexOrderOrGroupTicket:
          type: boolean
        TicketColor:
          type:
          - string
          - 'null'
        TicketClassName:
          type:
          - string
          - 'null'
        EventContactInfo:
          type:
          - string
          - 'null'
        OrderInfo:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - string
            - 'null'
        AttendeesDescription:
          type:
          - string
          - 'null'
        TimeSlotName:
          type:
          - string
          - 'null'
        SharedCapacityName:
          type:
          - string
          - 'null'
        LocationInfo:
          type:
          - string
          - 'null'
        DateInfo:
          type:
          - string
          - 'null'
        BundledTicketUrl:
          type:
          - string
          - 'null'
        IsBundledTicket:
          type: boolean
        StartsEndsSameDay:
          type: boolean
        Coordinates:
          type:
          - string
          - 'null'
        Address:
          type:
          - string
          - 'null'
        MapAddress:
          type:
          - string
          - 'null'
        ContactEmail:
          type:
          - string
          - 'null'
        ContactPhone:
          type:
          - string
          - 'null'
        IsFlexPass:
          type: boolean
      additionalProperties: false
    LookupResultOutput:
      type: object
      properties:
        Upcoming:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/LookupEventResultOutput'
        Past:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/LookupEventResultOutput'
        Email:
          type:
          - string
          - 'null'
      additionalProperties: false
    StringStringKeyValuePair:
      type: object
      properties:
        Key:
          type:
          - string
          - 'null'
        Value:
          type:
          - string
          - 'null'
      additionalProperties: false
    ApiModelError:
      type: object
      properties:
        Errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/StringStringKeyValuePair'
        Message:
          type:
          - string
          - 'null'
        Data: {}
        StackTrace:
          type:
          - string
          - 'null'
      additionalProperties: false
    EventDateOutput:
      type: object
      properties:
        DoorsAt:
          type:
          - string
          - 'null'
          format: date-time
        StartsAt:
          type: string
          format: date-time
        EndsAt:
          type:
          - string
          - 'null'
          format: date-time
      additionalProperties: false
    LookupGroupResultOutput:
      type: object
      properties:
        Id:
          type: string
          format: uuid
        GroupNumber:
          type: integer
          format: int64
        Name:
          type:
          - string
          - 'null'
        AttendeeCount:
          type: integer
          format: int32
      additionalProperties: false
    LookupCreateInput:
      required:
      - Email
      type: object
      properties:
        Email:
          minLength: 1
          pattern: ^([0-9A-Za-zÀ-ÖØ-öø-ÿ']+[-._+&])*[0-9A-Za-zÀ-ÖØ-öø-ÿ_']+@([-0-9A-Za-zÀ-ÖØ-öø-ÿ]+[.])+[a-zA-Z]{2,63}$
          type: string
        EventNumber:
          type:
          - integer
          - 'null'
          format: int64
        VerrisSubdomain:
          type:
          - string
          - 'null'
        VerrisCode:
          type:
          - string
          - 'null'
        VerrisUid:
          type:
          - string
          - 'null'
      additionalProperties: false
    EventDateItem:
      type: object
      properties:
        DoorsAt:
          type:
          - string
          - 'null'
          format: date-time
        StartsAt:
          type: string
          format: date-time
        EndsAt:
          type:
          - string
          - 'null'
          format: date-time
      additionalProperties: false
    AttendeeDisplayOutput:
      type: object
      properties:
        Line1:
          type:
          - string
          - 'null'
        Line2:
          type:
          - string
          - 'null'
        Line3:
          type:
          - string
          - 'null'
      additionalProperties: false
    EventListOutput:
      type: object
      properties:
        Title:
          type:
          - string
          - 'null'
        Subtitle:
          type:
          - string
          - 'null'
        UrlKey:
          type:
          - string
          - 'null'
        ClientKey:
          type:
          - string
          - 'null'
        ClientName:
          type:
          - string
          - 'null'
        Culture:
          type:
          - string
          - 'null'
        DateInfo:
          type:
          - string
          - 'null'
        DateInfoList:
          type:
          - array
          - 'null'
          items:
            type: string
        SoldOut:
          type: boolean
        IsSticky:
          type: boolean
        EventNumber:
          type: integer
          format: int64
        IsAssigned:
          type: boolean
        LocationName:
          type:
          - string
          - 'null'
        SessionCount:
          type: integer
          format: int32
        IsActive:
          type: boolean
        DateDisplay:
          $ref: '#/components/schemas/DateDisplayOutput'
        Latitude:
          type: number
          format: double
        Longitude:
          type: number
          format: double
        MapUrl:
          type:
          - string
          - 'null'
        PromoImageUrl:
          type:
          - string
          - 'null'
        CategoryId:
          type: integer
          format: int32
        CategoryName:
          type:
          - string
          - 'null'
        SpotsRemaining:
          type:
          - integer
          - 'null'
          format: int32
        SpotsTaken:
          type: integer
          format: int32
        ShowRemaining:
          type: boolean
        RemainingText:
          type:
          - string
          - 'null'
        Verbiage:
          type:
          - string
          - 'null'
        Dates:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/EventDateOutput'
        AlternateTitle:
          type:
          - string
          - 'null'
          readOnly: true
        TimeZoneId:
          type:
          - string
          - 'null'
        AreaName:
          type:
          - string
          - 'null'
        AreaKey:
          type:
          - string
          - 'null'
        PaymentProfileId:
          type:
          - string
          - 'null'
          format: uuid
        AcctCode:
          type:
          - string
          - 'null'
        IsHidden:
          type: boolean
        IsFlexPass:
          type: boolean
        IsExchangeable:
          type: boolean
      additionalProperties: false
    DateDisplayOutput:
      type: object
      properties:
        Months:
          type:
          - string
          - 'null'
        Dates:
          type:
          - string
          - 'null'
        Days:
          type:
          - string
          - 'null'
        Times:
          type:
          - string
          - 'null'
        IsOngoing:
          type: boolean
      additionalProperties: false
    TicketRenderType:
      enum:
      - Assigned
      - AssignedSection
      - GeneralAdmission
      - FlexPass
      - TimeSlot
      - Groups
      - Orders
      type: string
  securitySchemes:
    apiKey:
      type: apiKey
      description: The App Key you received from https://developer.brushfire.com/key
      name: Authorization
      in: header