Skip to main content

Deal

events object[]required

The events to book. At least one event is required, and every event's artists must be active on the agency's roster.

  • Array [
  • artistNotesstring

    Notes for the artist, shown on the booking.

    addressstring

    Street address of the event.

    additionalBonuses object[]

    Additional bonuses paid on top of the guarantee, flat or calculated from ticket tiers.

  • Array [
  • bonusAmountnumber

    Bonus amount in whole currency units, for FLAT_AMOUNT bonuses.

    bonusTypestring

    How the bonus is calculated: a flat amount, per ticket-tier count, or per ticket-tier amount.

    Possible values: [FLAT_AMOUNT, TICKET_TIER_COUNT, TICKET_TIER_AMOUNT]

    tierOperatorstring

    How multiple tiers combine: AND or OR.

    Possible values: [AND, OR]

    tiers object[]

    Ticket tiers the bonus is calculated from.

  • Array [
  • countinteger

    Tier ticket count, for TICKET_TIER_COUNT bonuses.

    amountnumber

    Tier amount in whole currency units, for TICKET_TIER_AMOUNT bonuses.

    bonusAmountnumber

    Bonus amount for this tier, in whole currency units.

  • ]
  • ]
  • announcementDateTimestring

    Embargo announcement date and time (YYYY-MM-DDThh:mm:ss). Requires announcementTrigger EMBARGO; when set without an explicit trigger, EMBARGO is inferred.

    announcementTriggerstring

    When the event may be announced: CONFIRMED when the event is confirmed, EMBARGO at the announcement date, NONE never.

    Possible values: [NONE, CONFIRMED, EMBARGO]

    artists object[]required

    The artists performing at this event. Each artist must be on the agency's roster, matched by roster entity id (or exact roster name).

  • Array [
  • namestring

    Artist name; matched against the roster when id is omitted.

    members object[]

    Artist members with their own splits. When omitted, the roster's default members are added.

  • Array [
  • namestring

    Member name.

    percentnumber

    Member's percent of the artist fee; when splitting, member percents must total 100.

    salesTaxnumber

    Sales tax percent applied to the member's share.

    salesTaxIdstring

    Sales tax rate id when using a stored rate.

    incomeTax object[]

    Income tax withholding for this member.

  • Array [
  • taxRatenumber

    Tax rate percent.

    surChargenumber

    Surcharge percent added on top of the tax rate.

    deductionnumber

    Deduction percent.

    postTaxboolean

    Whether the artist's income tax is applied after sales tax.

    taxAgentstring

    Who withholds the tax: the buyer (default) or the artist.

    Possible values: [buyer, artist]

    withholdBookingFeeWithArtistFeeboolean

    Whether the booking fee is withheld together with the artist fee.

  • ]
  • idstring

    Member's account id. Required when email is omitted.

    emailstring

    Member's email; used to match an existing account when id is omitted.

  • ]
  • splitByMembersboolean

    Whether the artist fee splits across members.

    fixedAmountnumber

    Fixed performance fee in whole currency units, replacing the percent split.

    percentnumber

    This artist's share of the deal as a percent number (85 = 85%). When multiple artists carry percents, they must total 100.

    amountnumber

    Artist fee in whole currency units.

    salesTaxnumber

    Sales tax percent applied to the artist fee.

    salesTaxIdstring

    Sales tax rate id when using a stored rate.

    incomeTax object[]

    Income tax withholding for this artist.

  • Array [
  • taxRatenumber

    Tax rate percent.

    surChargenumber

    Surcharge percent added on top of the tax rate.

    deductionnumber

    Deduction percent.

    postTaxboolean

    Whether the artist's income tax is applied after sales tax.

    taxAgentstring

    Who withholds the tax: the buyer (default) or the artist.

    Possible values: [buyer, artist]

    withholdBookingFeeWithArtistFeeboolean

    Whether the booking fee is withheld together with the artist fee.

  • ]
  • commissionPercentnumber

    Agency commission percent on this artist's fee.

    commissionSalesTaxnumber

    Sales tax percent on the agency commission.

    idstring

    Roster artist entity id. Required when name is omitted.

  • ]
  • billing object

    How the artist is billed: a billing type from the agency's billing-type presets and a percent.

    percentstring

    Billing percent, as a string percent number.

    typestring

    Billing type: exact-matched by id or display label against the agency's billing-type presets; an unmatched value is kept as-is.

    blockedReasonstring

    Reason the event is blocked. Setting it also marks the event blocked.

    bonusPercentnumber

    Percent of box office (gross or net, per bonusType) paid as a bonus, as a percent number (10 = 10%).

    bonusTypestring

    Box office basis for the bonus: GBOR (gross) or NBOR (net). Default GBOR.

    Possible values: [GBOR, NBOR]

    bookingFeeOnTopboolean

    Whether the agency booking fee is added on top of the deal total.

    buyerCommission object

    Commission the buyer pays: a flat amount, a percent of the guarantee, or a percent of fixed and variable expenses.

    buyerCommissionCalculationTypesstring[]

    Which parts of the deal the commission applies to: a flat amount, a percent of the guarantee, a percent of fixed expenses, or a percent of variable expenses.

    Possible values: [FLAT_AMOUNT, PERCENT_GUARANTEE, PERCENT_FIXED_EXPENSES, PERCENT_VARIABLE_EXPENSES]

    amountnumber

    Flat commission amount in whole currency units (500 = 500.00 USD), for FLAT_AMOUNT.

    percentstring

    Percent of the guarantee or expenses, as a string percent number ("10" = 10%), for the PERCENT_* calculation types.

    maxTotalnumber

    Cap on the commission, in whole currency units (500 = 500.00 USD); ignored for FLAT_AMOUNT.

    buyerExpenses object[]

    Buyer-borne expenses: flat amounts, amounts per ticket or per attendee, or percentages of box office.

  • Array [
  • calcTypestring

    How the expense is calculated: a flat amount, an amount per paid ticket or per attendee, or a percent of gross (PERCENT_GBOR) or net (PERCENT_NBOR) box office.

    Possible values: [FLAT_AMOUNT, AMOUNT_PER_TICKET, AMOUNT_PER_PERSON, PERCENT_NBOR, PERCENT_GBOR]

    typestring

    Expense type label.

    descriptionstring

    What the expense is for.

    amountnumber

    Flat, per-ticket, or per-attendee amount in whole currency units, depending on calcType.

    percentnumber

    Percent of box office when calcType is PERCENT_GBOR or PERCENT_NBOR.

    afternumber

    Box office threshold, in whole currency units, above which a percent expense starts to apply.

    maxTotalnumber

    Cap on the expense, in whole currency units.

    includeInSplitPointboolean

    Whether the expense is included when computing the artist split point.

    currencyTypestring

    ISO 4217 currency code; defaults to the event's currencyType.

  • ]
  • capacityinteger

    Venue capacity (head count).

    citystring

    City of the event.

    countrystring

    Country of the event.

    currencyTypestringrequired

    ISO 4217 currency code for the event's money values (for example USD); must be a currency the agency has enabled. Required.

    dealTypestring

    Deal structure: FLAT_GUARANTEE (default), STRAIGHT_PERCENTAGE, PLUS (guarantee plus a box office bonus), or VS (versus).

    Possible values: [FLAT_GUARANTEE, STRAIGHT_PERCENTAGE, PLUS, VS]

    descriptionstring

    Description of the event.

    durationinteger

    Performance length in minutes.

    endDateTimestring

    End date (YYYY-MM-DD) or end date-time (YYYY-MM-DDThh:mm:ss), local wall-clock — no UTC offset or Z suffix.

    guaranteenumber

    Guarantee in whole currency units of currencyType (7500 = 7,500.00 USD). Default 0.

    hardMerchinteger

    Artist's share of hard-merchandise sales, as a percent number (25 = 25%).

    merchSellerstring

    Merch seller: exact-matched by id or display label against the agency's merch-seller presets; an unmatched value is kept as-is.

    minimumAgestring

    Minimum age requirement (for example 18+, 21+).

    performanceTypestring

    Performance type: exact-matched by id or display label against the agency's performance-type presets; an unmatched value is kept as-is.

    radiusClause object

    Radius clause restricting nearby events before or after this one.

    radiusnumber

    Radius, in distanceUnit.

    distanceUnitstring

    Unit for radius. Default miles.

    beforeTimeValueinteger

    How long before the event the radius clause starts.

    beforeTimeUnitstring

    Unit for beforeTimeValue, for example days.

    afterTimeValueinteger

    How long after the event the radius clause runs.

    afterTimeUnitstring

    Unit for afterTimeValue, for example days.

    enabledboolean

    Whether the radius clause is active. Default true.

    rsvpUrlstring

    RSVP page URL.

    salesTaxInclusiveboolean

    Whether sales tax is included in the deal total.

    schedule object[]

    Day-of-show schedule entries, each with a date-time and the artists or members it applies to. Artists and members named in appliesTo must already be set in the event's artists; artists match by id or roster display name, members by account id or email.

  • Array [
  • typestring

    Schedule entry type: well-known values (loadIn, soundCheck, doorOpen, eventStart, performance, doorClose, loadOut, curfew) or an agency preset, matched by id or display name; an unmatched value is kept as-is.

    dateTimestring

    Start date-time (YYYY-MM-DDThh:mm:ss), local wall-clock. Required when dateType is DATE.

    endDateTimestring

    End date-time (YYYY-MM-DDThh:mm:ss), local wall-clock.

    appliesTo object

    Who this entry applies to: artists, artist members, or other preset values.

    artists object[]

    Artists this entry applies to, by roster entity id or display name.

  • Array [
  • namestring

    Artist name; matched against the roster when id is omitted.

    members object[]

    Artist members with their own splits. When omitted, the roster's default members are added.

  • Array [
  • namestring

    Member name.

    percentnumber

    Member's percent of the artist fee; when splitting, member percents must total 100.

    salesTaxnumber

    Sales tax percent applied to the member's share.

    salesTaxIdstring

    Sales tax rate id when using a stored rate.

    incomeTax object[]

    Income tax withholding for this member.

  • Array [
  • taxRatenumber

    Tax rate percent.

    surChargenumber

    Surcharge percent added on top of the tax rate.

    deductionnumber

    Deduction percent.

    postTaxboolean

    Whether the artist's income tax is applied after sales tax.

    taxAgentstring

    Who withholds the tax: the buyer (default) or the artist.

    Possible values: [buyer, artist]

    withholdBookingFeeWithArtistFeeboolean

    Whether the booking fee is withheld together with the artist fee.

  • ]
  • idstring

    Member's account id. Required when email is omitted.

    emailstring

    Member's email; used to match an existing account when id is omitted.

  • ]
  • splitByMembersboolean

    Whether the artist fee splits across members.

    fixedAmountnumber

    Fixed performance fee in whole currency units, replacing the percent split.

    percentnumber

    This artist's share of the deal as a percent number (85 = 85%). When multiple artists carry percents, they must total 100.

    amountnumber

    Artist fee in whole currency units.

    salesTaxnumber

    Sales tax percent applied to the artist fee.

    salesTaxIdstring

    Sales tax rate id when using a stored rate.

    incomeTax object[]

    Income tax withholding for this artist.

  • Array [
  • taxRatenumber

    Tax rate percent.

    surChargenumber

    Surcharge percent added on top of the tax rate.

    deductionnumber

    Deduction percent.

    postTaxboolean

    Whether the artist's income tax is applied after sales tax.

    taxAgentstring

    Who withholds the tax: the buyer (default) or the artist.

    Possible values: [buyer, artist]

    withholdBookingFeeWithArtistFeeboolean

    Whether the booking fee is withheld together with the artist fee.

  • ]
  • commissionPercentnumber

    Agency commission percent on this artist's fee.

    commissionSalesTaxnumber

    Sales tax percent on the agency commission.

    idstring

    Roster artist entity id. Required when name is omitted.

  • ]
  • artistMembers object[]

    Artist members this entry applies to, by account id or email.

  • Array [
  • namestring

    Member name.

    percentnumber

    Member's percent of the artist fee; when splitting, member percents must total 100.

    salesTaxnumber

    Sales tax percent applied to the member's share.

    salesTaxIdstring

    Sales tax rate id when using a stored rate.

    incomeTax object[]

    Income tax withholding for this member.

  • Array [
  • taxRatenumber

    Tax rate percent.

    surChargenumber

    Surcharge percent added on top of the tax rate.

    deductionnumber

    Deduction percent.

    postTaxboolean

    Whether the artist's income tax is applied after sales tax.

    taxAgentstring

    Who withholds the tax: the buyer (default) or the artist.

    Possible values: [buyer, artist]

    withholdBookingFeeWithArtistFeeboolean

    Whether the booking fee is withheld together with the artist fee.

  • ]
  • idstring

    Member's account id. Required when email is omitted.

    emailstring

    Member's email; used to match an existing account when id is omitted.

  • ]
  • otherstring[]

    Preset values this entry applies to: exact-matched by id or display label against the agency's event-schedule-actor presets; an unmatched value is kept as-is.

    locationstring

    Location of the entry: exact-matched by id or display label against the agency's event-schedule-location presets; an unmatched value is kept as-is.

    dateTypestring

    Date certainty: DATE for a concrete timed entry, MAD for a mutually agreeable date, or a placeholder (TBD, TBA, TBC). Default DATE.

    Possible values: [TBD, TBA, TBC, MAD, DATE]

  • ]
  • sharedNotesstring

    Notes shared with the artist.

    softMerchinteger

    Artist's share of soft-merchandise sales, as a percent number (25 = 25%).

    startDateTimestring

    Event date (YYYY-MM-DD) or date-time (YYYY-MM-DDThh:mm:ss), local wall-clock — never with a UTC offset or Z suffix. Required unless mutuallyAgreeableDate is true. When a time is present, timeZone is required.

    statestring

    State or province of the event.

    statusstring

    Initial event status. Default tentative; an agency set to confirm bookings at creation may confirm it.

    Possible values: [tentative, confirmed, blocked, canceled]

    summarystring

    Short summary of the event.

    supportstring[]

    Supporting acts, by name or id.

    ticketOnSaleDateTimestring

    Ticket on-sale date-time (YYYY-MM-DDThh:mm:ss).

    ticketPresaleDateTimestring

    Ticket presale date-time (YYYY-MM-DDThh:mm:ss).

    tickets object

    Ticket scale: named tiers with prices and counts, plus ticket fee rules.

    tiers object[]

    Ticket tiers with names, prices, and counts.

  • Array [
  • actualsinteger

    Actual tickets sold.

    compsinteger

    Complimentary tickets.

    namestring

    Tier name. Required.

    plannedinteger

    Planned ticket count.

    plannedCompsinteger

    Planned complimentary tickets.

    pricenumber

    Tier price in whole currency units.

    excludeFromBreakEvenboolean

    Whether the tier is excluded from break-even calculations.

  • ]
  • finalboolean

    Whether these are final (actual) ticket counts rather than a scale.

    cumulativeFees object[]

    Ticket fees calculated on cumulative ticket counts across tiers.

  • Array [
  • typestring

    Fee type: exact-matched by id or display label against the agency's ticket-fee presets; an unmatched value is kept as-is. Required.

    descriptionstring

    What the fee is for.

    amountnumber

    Set exactly one of amount or percent. The amount is in whole currency units.

    estimatedAmountnumber

    Estimated fee amount in whole currency units; defaults to amount.

    percentnumber

    Set exactly one of amount or percent. The percent is a number (2.5 = 2.5%).

    mathTypestring

    How the fee applies to the ticket count: MULTIPLIER or DIVISOR; defaults to the matching ticket-fee preset's math type, otherwise DIVISOR.

    Possible values: [MULTIPLIER, DIVISOR]

    maxTotalnumber

    Cap on the fee, in whole currency units.

  • ]
  • includedFees object[]

    Ticket fees included in the deal total.

  • Array [
  • typestring

    Fee type: exact-matched by id or display label against the agency's ticket-fee presets; an unmatched value is kept as-is. Required.

    descriptionstring

    What the fee is for.

    amountnumber

    Set exactly one of amount or percent. The amount is in whole currency units.

    estimatedAmountnumber

    Estimated fee amount in whole currency units; defaults to amount.

    percentnumber

    Set exactly one of amount or percent. The percent is a number (2.5 = 2.5%).

    mathTypestring

    How the fee applies to the ticket count: MULTIPLIER or DIVISOR; defaults to the matching ticket-fee preset's math type, otherwise DIVISOR.

    Possible values: [MULTIPLIER, DIVISOR]

    maxTotalnumber

    Cap on the fee, in whole currency units.

  • ]
  • independentFees object[]

    Ticket fees calculated per tier independently.

  • Array [
  • typestring

    Fee type: exact-matched by id or display label against the agency's ticket-fee presets; an unmatched value is kept as-is. Required.

    descriptionstring

    What the fee is for.

    amountnumber

    Set exactly one of amount or percent. The amount is in whole currency units.

    estimatedAmountnumber

    Estimated fee amount in whole currency units; defaults to amount.

    percentnumber

    Set exactly one of amount or percent. The percent is a number (2.5 = 2.5%).

    mathTypestring

    How the fee applies to the ticket count: MULTIPLIER or DIVISOR; defaults to the matching ticket-fee preset's math type, otherwise DIVISOR.

    Possible values: [MULTIPLIER, DIVISOR]

    maxTotalnumber

    Cap on the fee, in whole currency units.

  • ]
  • ticketUrlstring

    Public ticketing page URL.

    timeZonestring

    IANA time zone id (for example America/Los_Angeles) for the event's date-times. Required when any date carries a time.

    typestring

    Event type: exact-matched by id or display label against the agency's event-type presets; an unmatched value is kept as-is.

    venue object

    The venue: an organization; a new venue record is created when no match exists.

    org object

    The venue's organization: name plus optional contact details. A new venue record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • zipstring

    Postal code of the event.

    foreignIdstring

    Your own identifier for the event, stored as-is.

    eventDateNotestring

    A note about the event date, for example when the date is approximate.

    mutuallyAgreeableDateboolean

    Set true to book an undated, mutually agreeable date; startDateTime must then be omitted.

  • ]
  • assignments object

    Agency members assigned to the booking: agents, assistants, logisticians, and marketing contacts. Agents may be given explicitly or omitted to use each roster artist's default assignments.

    agents object[]

    Agents on the booking, by account id or email. Omit to use each roster artist's default assignments; creation fails when no agent can be resolved.

  • Array [
  • namestring

    Member display name.

    firstNamestring

    Member's first name.

    lastNamestring

    Member's last name.

    defaultCommissionPercentnumber

    Default agency commission percent for this agent, as a percent number.

    defaultCommissionAmountnumber

    Default agency commission amount for this agent, in whole currency units.

    isSellingAgentboolean

    Whether this agent is the selling agent.

    salesTaxnumber

    Sales tax percent applied to this agent's fee.

    idstring

    Member's account id. Required when email is omitted.

    emailstring

    Member's email; used to match an existing account when id is omitted.

  • ]
  • assistants object[]

    Assistants on the booking, by account id or email.

  • Array [
  • namestring

    Member display name.

    firstNamestring

    Member's first name.

    lastNamestring

    Member's last name.

    idstring

    Member's account id. Required when email is omitted.

    emailstring

    Member's email; used to match an existing account when id is omitted.

  • ]
  • logisticians object[]

    Logisticians on the booking, by account id or email.

  • Array [
  • namestring

    Member display name.

    firstNamestring

    Member's first name.

    lastNamestring

    Member's last name.

    idstring

    Member's account id. Required when email is omitted.

    emailstring

    Member's email; used to match an existing account when id is omitted.

  • ]
  • marketing object[]

    Marketing contacts on the booking, by account id or email.

  • Array [
  • namestring

    Member display name.

    firstNamestring

    Member's first name.

    lastNamestring

    Member's last name.

    idstring

    Member's account id. Required when email is omitted.

    emailstring

    Member's email; used to match an existing account when id is omitted.

  • ]
  • contacts object

    The people and organizations on the booking, keyed by role: buyer, signer, promoter, and others. The buyer is required.

    buyer object

    The buyer: a person (an email is required, plus one of firstName/lastName) and an organization (optional; when given, its name matches an existing organization or creates one).

    person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signer object

    The signing contact.

    person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • counterSigner object

    The counter-signing contact.

    person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • advancing object

    The advancing contact.

    person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • facilities object

    The facilities contact.

    person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • liaison object

    The liaison contact.

    person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • logisticsContact object

    The logistics contact.

    person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • marketingContact object

    The marketing contact.

    person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • payer object

    The payer.

    person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • producer object

    The producer.

    person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • promoter object

    The promoter.

    person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • runnerContacts object[]

    Day-of-show runners for the artist.

  • Array [
  • person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • ]
  • ticketCountContact object

    The ticket-count contact.

    person object

    The contact's person details: an email and at least one of firstName/lastName, plus address, phone, and website.

    firstNamestring

    First name. Required when lastName is omitted.

    lastNamestring

    Last name. Required when firstName is omitted.

    emailstring

    Email address. Required for every person you send; it matches an existing contact or creates a new one.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumber object[]

    Phone numbers.

  • Array [
  • primaryboolean

    Whether this is the primary phone number.

    typestring

    Number type. Default main.

    numberstring

    The phone number.

  • ]
  • website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • signerFirstNamestring

    First name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    signerLastNamestring

    Last name recorded for a signer or counter-signer entry when it differs from the contact's own name.

    org object

    The contact's organization. A new organization record is created when no match exists.

    namestring

    Organization name; used to match or create the organization record. Required when an organization is given.

    emailstring

    Organization email address.

    address object[]

    Postal addresses.

  • Array [
  • addressstring

    Street address.

    citystring

    City.

    statestring

    State or province.

    subregionstring

    Subregion.

    zipCodestring

    Postal code.

    countrystring

    Country.

    timezonestring

    IANA time zone id.

    primaryboolean

    Whether this is the primary address.

  • ]
  • phoneNumberstring[]

    Phone numbers.

    website object[]

    Websites.

  • Array [
  • primaryboolean

    Whether this is the primary website.

    labelstring

    Display label.

    hrefstring

    The URL.

  • ]
  • payments object[]

    A custom payment schedule. When omitted, the agency's default payment-plan preset is applied. Exactly one payment must have remainder set to true.

  • Array [
  • percentnumber

    Percent of the deal total due at this step, as a percent number (50 = 50%). Used to derive a payment item when items is omitted.

    amountnumber

    Payment amount in whole currency units. Used to derive a payment item when items is omitted.

    statusstring

    Status of the created payment. Default CREATED.

    Possible values: [CREATED, BILLED, PAYMENT_PENDING, PAID, REFUNDED]

    titlestring

    Payment title. Defaults to the payment's position, e.g. "Payment 0" for the first payment.

    remainderboolean

    Marks the payment that captures whatever remains after the other payments. Exactly one remainder payment is required.

    depositboolean

    Whether this payment is a deposit.

    dueDatestring

    Due date (YYYY-MM-DD, no time component). Required unless dueOnSite is true or relativeDueDate is given.

    relativeDueDate object

    Due date relative to a trigger event, as an alternative to dueDate; the two cannot be combined.

    valueinteger

    Number of units (see unit) relative to the trigger event. Default 3.

    unitstring

    Time unit for value. Only DAYS is accepted for payment due dates.

    Possible values: [DAYS]

    beforeOrAfterstring

    Whether the due date falls before or after the trigger event.

    Possible values: [BEFORE, AFTER, WHEN, ON]

    triggerEventstring

    Event the due date is relative to. Accepted for payment due dates: CONTRACT_ISSUED, CONTRACT_SIGNED, EVENT_DATE, FIRST_EVENT_DATE, LAST_EVENT_DATE.

    Possible values: [CONTRACT_ISSUED, CONTRACT_SIGNED, EVENT_DATE, FIRST_EVENT_DATE, LAST_EVENT_DATE]

    dateTimestring

    Fixed due date (YYYY-MM-DD, no time component). Required when userManaged is true.

    timeZonestring

    IANA time zone id for dateTime.

    userManagedboolean

    Set true to manage the due date manually; requires dateTime.

    dueOnSiteboolean

    Set true to make the payment due on site, which removes the dueDate requirement; the due date defaults to the event date.

    manualPaymentMethodstring

    Payment method label for payments collected outside the platform.

    refundPaymentMethodstring

    Payment method label for refunds.

    referenceCodestring

    Bank or ACH memo recorded with the payment; surfaces on the invoice as its payment reference number.

    offerItemTypestring

    What this payment covers, for example PERFORMANCE_FEE_GUARANTEE (default). Used to derive a payment item when items is omitted.

    Possible values: [PERFORMANCE_FEE_GUARANTEE, ARTIST_PERFORMANCE_FEE, ARTIST_MEMBER_FEE, PERFORMANCE_FEE_BONUS, BOOKING_FEE_GUARANTEE, BOOKING_FEE, ARTIST_MEMBER_BOOKING_FEE, AGENCY_FEE, AGENT_FEE, BOOKING_FEE_BONUS, EXPENSE]

    items object[]

    Line items for this payment; each item needs offerItemType and either percent, amount, or remainder. Leave items empty for the remainder payment. When omitted, a single item is derived from the payment's percent, amount, and offerItemType.

  • Array [
  • percentnumber

    Percent of the deal total for this item, as a percent number.

    amountnumber

    Item amount in whole currency units.

    remainderboolean

    Set true to make this item capture the remainder.

    offerItemTypestring

    What this item covers, for example PERFORMANCE_FEE_GUARANTEE. Required.

    Possible values: [PERFORMANCE_FEE_GUARANTEE, ARTIST_PERFORMANCE_FEE, ARTIST_MEMBER_FEE, PERFORMANCE_FEE_BONUS, BOOKING_FEE_GUARANTEE, BOOKING_FEE, ARTIST_MEMBER_BOOKING_FEE, AGENCY_FEE, AGENT_FEE, BOOKING_FEE_BONUS, EXPENSE]

  • ]
  • ]
  • phrases object

    Contract phrase values keyed by phrase id, each a list of lines.

    property name* string[]
  • Array [
  • string
  • ]
  • internalNotesstring

    Internal notes attached to the booking; visible to agency members, not to the buyer.

    Deal
    {
    "events": [
    {
    "artistNotes": "string",
    "address": "string",
    "additionalBonuses": [
    {
    "bonusAmount": 0,
    "bonusType": "FLAT_AMOUNT",
    "tierOperator": "AND",
    "tiers": [
    {
    "count": 0,
    "amount": 0,
    "bonusAmount": 0
    }
    ]
    }
    ],
    "announcementDateTime": "string",
    "announcementTrigger": "NONE",
    "artists": [
    {
    "name": "string",
    "members": [
    {
    "name": "string",
    "percent": 0,
    "salesTax": 0,
    "salesTaxId": "string",
    "incomeTax": [
    {
    "taxRate": 0,
    "surCharge": 0,
    "deduction": 0,
    "postTax": true,
    "taxAgent": "buyer",
    "withholdBookingFeeWithArtistFee": true
    }
    ],
    "id": "string",
    "email": "string"
    }
    ],
    "splitByMembers": true,
    "fixedAmount": 0,
    "percent": 0,
    "amount": 0,
    "salesTax": 0,
    "salesTaxId": "string",
    "incomeTax": [
    {
    "taxRate": 0,
    "surCharge": 0,
    "deduction": 0,
    "postTax": true,
    "taxAgent": "buyer",
    "withholdBookingFeeWithArtistFee": true
    }
    ],
    "commissionPercent": 0,
    "commissionSalesTax": 0,
    "id": "string"
    }
    ],
    "billing": {
    "percent": "string",
    "type": "string"
    },
    "blockedReason": "string",
    "bonusPercent": 0,
    "bonusType": "GBOR",
    "bookingFeeOnTop": true,
    "buyerCommission": {
    "buyerCommissionCalculationTypes": [
    "FLAT_AMOUNT"
    ],
    "amount": 0,
    "percent": "string",
    "maxTotal": 0
    },
    "buyerExpenses": [
    {
    "calcType": "FLAT_AMOUNT",
    "type": "string",
    "description": "string",
    "amount": 0,
    "percent": 0,
    "after": 0,
    "maxTotal": 0,
    "includeInSplitPoint": true,
    "currencyType": "string"
    }
    ],
    "capacity": 0,
    "city": "string",
    "country": "string",
    "currencyType": "string",
    "dealType": "FLAT_GUARANTEE",
    "description": "string",
    "duration": 0,
    "endDateTime": "string",
    "guarantee": 0,
    "hardMerch": 0,
    "merchSeller": "string",
    "minimumAge": "string",
    "performanceType": "string",
    "radiusClause": {
    "radius": 0,
    "distanceUnit": "string",
    "beforeTimeValue": 0,
    "beforeTimeUnit": "string",
    "afterTimeValue": 0,
    "afterTimeUnit": "string",
    "enabled": true
    },
    "rsvpUrl": "string",
    "salesTaxInclusive": true,
    "schedule": [
    {
    "type": "string",
    "dateTime": "string",
    "endDateTime": "string",
    "appliesTo": {
    "artists": [
    {
    "name": "string",
    "members": [
    {
    "name": "string",
    "percent": 0,
    "salesTax": 0,
    "salesTaxId": "string",
    "incomeTax": [
    {
    "taxRate": 0,
    "surCharge": 0,
    "deduction": 0,
    "postTax": true,
    "taxAgent": "buyer",
    "withholdBookingFeeWithArtistFee": true
    }
    ],
    "id": "string",
    "email": "string"
    }
    ],
    "splitByMembers": true,
    "fixedAmount": 0,
    "percent": 0,
    "amount": 0,
    "salesTax": 0,
    "salesTaxId": "string",
    "incomeTax": [
    {
    "taxRate": 0,
    "surCharge": 0,
    "deduction": 0,
    "postTax": true,
    "taxAgent": "buyer",
    "withholdBookingFeeWithArtistFee": true
    }
    ],
    "commissionPercent": 0,
    "commissionSalesTax": 0,
    "id": "string"
    }
    ],
    "artistMembers": [
    {
    "name": "string",
    "percent": 0,
    "salesTax": 0,
    "salesTaxId": "string",
    "incomeTax": [
    {
    "taxRate": 0,
    "surCharge": 0,
    "deduction": 0,
    "postTax": true,
    "taxAgent": "buyer",
    "withholdBookingFeeWithArtistFee": true
    }
    ],
    "id": "string",
    "email": "string"
    }
    ],
    "other": [
    "string"
    ]
    },
    "location": "string",
    "dateType": "TBD"
    }
    ],
    "sharedNotes": "string",
    "softMerch": 0,
    "startDateTime": "string",
    "state": "string",
    "status": "tentative",
    "summary": "string",
    "support": [
    "string"
    ],
    "ticketOnSaleDateTime": "string",
    "ticketPresaleDateTime": "string",
    "tickets": {
    "tiers": [
    {
    "actuals": 0,
    "comps": 0,
    "name": "string",
    "planned": 0,
    "plannedComps": 0,
    "price": 0,
    "excludeFromBreakEven": true
    }
    ],
    "final": true,
    "cumulativeFees": [
    {
    "type": "string",
    "description": "string",
    "amount": 0,
    "estimatedAmount": 0,
    "percent": 0,
    "mathType": "MULTIPLIER",
    "maxTotal": 0
    }
    ],
    "includedFees": [
    {
    "type": "string",
    "description": "string",
    "amount": 0,
    "estimatedAmount": 0,
    "percent": 0,
    "mathType": "MULTIPLIER",
    "maxTotal": 0
    }
    ],
    "independentFees": [
    {
    "type": "string",
    "description": "string",
    "amount": 0,
    "estimatedAmount": 0,
    "percent": 0,
    "mathType": "MULTIPLIER",
    "maxTotal": 0
    }
    ]
    },
    "ticketUrl": "string",
    "timeZone": "string",
    "type": "string",
    "venue": {
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    },
    "zip": "string",
    "foreignId": "string",
    "eventDateNote": "string",
    "mutuallyAgreeableDate": true
    }
    ],
    "assignments": {
    "agents": [
    {
    "name": "string",
    "firstName": "string",
    "lastName": "string",
    "defaultCommissionPercent": 0,
    "defaultCommissionAmount": 0,
    "isSellingAgent": true,
    "salesTax": 0,
    "id": "string",
    "email": "string"
    }
    ],
    "assistants": [
    {
    "name": "string",
    "firstName": "string",
    "lastName": "string",
    "id": "string",
    "email": "string"
    }
    ],
    "logisticians": [
    {
    "name": "string",
    "firstName": "string",
    "lastName": "string",
    "id": "string",
    "email": "string"
    }
    ],
    "marketing": [
    {
    "name": "string",
    "firstName": "string",
    "lastName": "string",
    "id": "string",
    "email": "string"
    }
    ]
    },
    "contacts": {
    "buyer": {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    },
    "signer": {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    },
    "counterSigner": {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    },
    "advancing": {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    },
    "facilities": {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    },
    "liaison": {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    },
    "logisticsContact": {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    },
    "marketingContact": {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    },
    "payer": {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    },
    "producer": {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    },
    "promoter": {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    },
    "runnerContacts": [
    {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    }
    ],
    "ticketCountContact": {
    "person": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    {
    "primary": true,
    "type": "string",
    "number": "string"
    }
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ],
    "signerFirstName": "string",
    "signerLastName": "string"
    },
    "org": {
    "name": "string",
    "email": "string",
    "address": [
    {
    "address": "string",
    "city": "string",
    "state": "string",
    "subregion": "string",
    "zipCode": "string",
    "country": "string",
    "timezone": "string",
    "primary": true
    }
    ],
    "phoneNumber": [
    "string"
    ],
    "website": [
    {
    "primary": true,
    "label": "string",
    "href": "string"
    }
    ]
    }
    }
    },
    "payments": [
    {
    "percent": 0,
    "amount": 0,
    "status": "CREATED",
    "title": "string",
    "remainder": true,
    "deposit": true,
    "dueDate": "string",
    "relativeDueDate": {
    "value": 0,
    "unit": "DAYS",
    "beforeOrAfter": "BEFORE",
    "triggerEvent": "CONTRACT_ISSUED",
    "dateTime": "string",
    "timeZone": "string",
    "userManaged": true
    },
    "dueOnSite": true,
    "manualPaymentMethod": "string",
    "refundPaymentMethod": "string",
    "referenceCode": "string",
    "offerItemType": "PERFORMANCE_FEE_GUARANTEE",
    "items": [
    {
    "percent": 0,
    "amount": 0,
    "remainder": true,
    "offerItemType": "PERFORMANCE_FEE_GUARANTEE"
    }
    ]
    }
    ],
    "phrases": {},
    "internalNotes": "string"
    }