Get a line item by ID

curl --request GET \
  --url https://api.letsdothis.com/v0/line-items/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.letsdothis.com/v0/line-items/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "addonCategory": null,
  "addonName": null,
  "addonVariantName": null,
  "amount": 6500,
  "attributedLineItemId": null,
  "attributedLineItemType": null,
  "bookerEmailAddress": "john@invalid.test",
  "bookerName": "John Runner",
  "bookingId": "66b1c2d3e4f5061728394a5b",
  "bookingType": "ENTRY",
  "currencyCode": "USD",
  "eventId": "66a1b2c3d4e5f60718293a4b",
  "eventOccurrenceId": "66a2b3c4d5e6f708192a3b4c",
  "eventOccurrenceTitle": "City River Run",
  "financialEntryId": "66c2d3e4f5061728394a5b6c",
  "id": "66c1d2e3f40516273849a5b6",
  "incrementalStatus": "INCREMENTAL",
  "isRefund": false,
  "ldtAmount": 500,
  "lineItemName": "10K General Entry",
  "itemId": "66a4b5c6d7e8f9012a3b4c5d",
  "itemSelectionId": null,
  "lineItemType": "TICKET",
  "organizerAmount": 6000,
  "participantId": "7d22e97f-b583-4e5b-a2bb-1b927f826a32",
  "paymentCompletedAt": "2026-05-12T16:45:03.000Z",
  "paymentId": "pi_test_cityriver_1042",
  "paymentReference": "payref_demo_1042",
  "paymentRefundId": null,
  "paymentStatus": "FUNDS_COMPLETE",
  "payoutId": "po_test_cityriver_1042",
  "quantity": 1,
  "raceTitle": "10K",
  "raceId": "66a3b4c5d6e7f8092a3b4c5d",
  "startlistEntryId": "66b2c3d4e5f60718293a4b5c",
  "thirdPartyAmount": 0,
  "ticketId": "66a4b5c6d7e8f9012a3b4c5d",
  "ticketSlug": "city-river-run-10k",
  "ticketTitle": "10K General Entry",
  "transactionAt": "2026-05-12T16:45:00.000Z",
  "createdAt": "2026-05-12T16:45:00.000Z",
  "updatedAt": "2026-05-12T16:45:03.000Z"
}

{
  "statusCode": 404,
  "error": "<string>",
  "message": "<string>"
}

GET

line-items

{id}

Get a line item by ID

curl --request GET \
  --url https://api.letsdothis.com/v0/line-items/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.letsdothis.com/v0/line-items/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "addonCategory": null,
  "addonName": null,
  "addonVariantName": null,
  "amount": 6500,
  "attributedLineItemId": null,
  "attributedLineItemType": null,
  "bookerEmailAddress": "john@invalid.test",
  "bookerName": "John Runner",
  "bookingId": "66b1c2d3e4f5061728394a5b",
  "bookingType": "ENTRY",
  "currencyCode": "USD",
  "eventId": "66a1b2c3d4e5f60718293a4b",
  "eventOccurrenceId": "66a2b3c4d5e6f708192a3b4c",
  "eventOccurrenceTitle": "City River Run",
  "financialEntryId": "66c2d3e4f5061728394a5b6c",
  "id": "66c1d2e3f40516273849a5b6",
  "incrementalStatus": "INCREMENTAL",
  "isRefund": false,
  "ldtAmount": 500,
  "lineItemName": "10K General Entry",
  "itemId": "66a4b5c6d7e8f9012a3b4c5d",
  "itemSelectionId": null,
  "lineItemType": "TICKET",
  "organizerAmount": 6000,
  "participantId": "7d22e97f-b583-4e5b-a2bb-1b927f826a32",
  "paymentCompletedAt": "2026-05-12T16:45:03.000Z",
  "paymentId": "pi_test_cityriver_1042",
  "paymentReference": "payref_demo_1042",
  "paymentRefundId": null,
  "paymentStatus": "FUNDS_COMPLETE",
  "payoutId": "po_test_cityriver_1042",
  "quantity": 1,
  "raceTitle": "10K",
  "raceId": "66a3b4c5d6e7f8092a3b4c5d",
  "startlistEntryId": "66b2c3d4e5f60718293a4b5c",
  "thirdPartyAmount": 0,
  "ticketId": "66a4b5c6d7e8f9012a3b4c5d",
  "ticketSlug": "city-river-run-10k",
  "ticketTitle": "10K General Entry",
  "transactionAt": "2026-05-12T16:45:00.000Z",
  "createdAt": "2026-05-12T16:45:00.000Z",
  "updatedAt": "2026-05-12T16:45:03.000Z"
}

{
  "statusCode": 404,
  "error": "<string>",
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

The ID of the resource to query by

Query Parameters

source

enum<string> | null

Data source. When set to "mongodb", reads from the MongoDB collection.

Available options:

mongodb,

null

Response

Default Response

A financial line item recorded for an organizer.

addonCategory

string | null

required

The category of the add-on. This only applies to add-ons sold in the add-ons page in the checkout flow, not price-adjusting fields in the participant details page.

Example:

"Clothing"

addonName

string | null

required

The name of the add-on. This only applies to add-ons sold in the add-ons page in the checkout flow, not price-adjusting fields in the participant details page.

Example:

"Sweatshirt"

addonVariantName

string | null

required

Name of the add-on variant. A variant is a specific option of an add-on. For example, 'XL' may be a variant of a t-shirt. This only applies to add-ons sold in the add-ons page in the checkout flow, not price-adjusting fields in the participant details page.

Example:

"Women's X Large"

amount

number | null

required

Total value of the LineItem.

Example:

5000

attributedLineItemId

string | null

required

The ID of the LineItem that this LineItem applies to. E.g., a discount may apply to a ticket or an add-on.

Example:

"dfe27034-85f5-4aac-8cf5-6d7024829679"

attributedLineItemType

enum<string> | null

required

The type of the LineItem that this LineItem applies to. E.g., a discount may apply to a ticket or an add-on. Discount codes can be applied to tickets, add-ons, booking fees and memberships.

Available options:

TICKET,

ADD_ON,

BOOKING_FEE,

DISCOUNT,

MEMBERSHIP

bookerEmailAddress

string<email> | null

required

Email address of booker making the purchase. This will be empty if the LineItem is not created from a booking, e.g., for a standalone membership purchase.

bookerName

string | null

required

Name of booker making the purchase.

Example:

"John Smith"

bookingId

string | null

required

The unique identifier of the booking resulting in the registration. If the LineItem is not created from a booking, e.g., a standalone membership purchase, this will not be set.

bookingType

enum<string> | null

required

Available options:

ENTRY,

APPLICATION

currencyCode

enum<string> | null

required

Available options:

AUD,

CAD,

DKK,

EUR,

GBP,

INR,

MXN,

PHP,

USD,

ZERO

eventId

string | null

required

The unique identifier of the Event.

Example:

"2365756"

eventOccurrenceId

string | null

required

The unique identifier of the event occurrence.

Example:

"234676543146"

eventOccurrenceTitle

string | null

required

The name of the event occurrence.

financialEntryId

string | null

required

Unique identifier for the financial entry. One financial entry is the equivalent of either:

basket purchase containing multiple line items,
a refund
an amendment to another financial data entry.

Therefore, the booker name and incrementality will be consistent across all LineItems with the same unique identifier for the financial entry.

string

required

incrementalStatus

enum<string> | null

required

Identifies whether the booking was incremental (i.e., LDT driven) or non-incremental (i.e., EO driven). An incremental transaction comes through Let's Do This channels.

Available options:

INCREMENTAL,

NON_INCREMENTAL,

PENDING,

UNSPECIFIED,

UNRECOGNIZED

isRefund

boolean | null

required

Returns true if the LineItem is a refund.

ldtAmount

number | null

required

Total amount paid to LDT (before tax), including commission and payment processing.

Example:

300

lineItemName

string | null

required

The name of the LineItem providing detailed description of what was purchased.

Example:

"X Large T-shirt"

itemId

string | null

required

The ID of associated booking item.

Example:

"1e2601e0-1f86-4276-9448-9c9810526ee1"

itemSelectionId

string | null

required

The ID of associated booking item variant.

Example:

"37134b3f-29dc-49e6-9185-f0d4f2cbbc5a"

lineItemType

enum<string> | null

required

Available options:

TICKET,

ADD_ON,

BOOKING_FEE,

DISCOUNT,

CREDIT,

GIFT_CARD,

REFUNDABLE_PURCHASE,

MISC,

PROXY_ADJUSTMENT,

UNUSED_DISCOUNT_AMOUNT,

DONATION,

MEMBERSHIP

organizerAmount

number | null

required

Total amount paid to organizer (before tax).

Example:

4700

participantId

string | null

required

paymentCompletedAt

string | null

required

Date and time when the funds were transferred between LDT and the account receiving the payment. The account receiving the payment often belongs to the EO, but in some instances may belong to another third party (e.g., a charity).

Example:

"2026-05-08T11:30:00.000Z"

paymentId

string | null

required

The Stripe payment ID for transactions that are paid into the receiving account from the LDT account.

paymentReference

string | null

required

Unique identifier used by LDT which allows for tracking all LineItems back to a singular payment made. It is different from the Stripe payment reference but serves a similar purpose in practice.

paymentRefundId

string | null

required

The Stripe ID when a payment is reversed (if applicable). A reversed payment includes refunds, failed payments (e.g., due to insufficient funds) or a payment dispute reversal.

paymentStatus

enum<string> | null

required

Payment status of the financial transaction. If the status is 'FUNDS_COMPLETE', it indicates that the funds have been successfully transferred to the respective parties involved.

Available options:

FUNDS_COMPLETE,

READY,

CANCELLED,

REFUNDED

payoutId

string | null

required

Unique identifier for the payouts made from Stripe into the recipient bank account.

quantity

number | null

required

Represents the number of LineItems sold.

For refunds, this value will be -1.
For financial data amendments, the value will be 0 to prevent double-counting.
For the 2nd+ installments of payment plan transactions, this will be 0, to avoid counting the same LineItem multiple times.
For all other cases, the value will be +1.

Example:

1

raceTitle

string | null

required

The name of the race this LineItem belongs to.

raceId

string | null

required

Unique identifier of the race this LineItem belongs to.

startlistEntryId

string | null

required

Startlist entry ID for the LineItem. Not all LineItems have an associated startlist entry ID.

thirdPartyAmount

number | null

required

Total amount paid to third parties (before tax).

Example:

0

ticketId

string | null

required

The unique identifier for a ticket this LineItem belongs to.

ticketSlug

string | null

required

The slug for a ticket this LineItem belongs to.

ticketTitle

string | null

required

The name of the ticket this LineItem belongs to.

transactionAt

string | null

required

Date and time at which the transaction occurred.

Example:

"2026-05-08T11:30:00.000Z"

createdAt

string | null

required

The time and date this LineItem was created.

Example:

"2026-05-08T11:30:00.000Z"

updatedAt

string | null

required

The time and date this LineItem was updated.

Example:

"2026-05-08T11:30:00.000Z"