Passer au contenu principal
POST
/
v1
/
events
/
simulate-prices
Simulate billable event prices
curl --request POST \
  --url https://ingest.hyperline.co/v1/events/simulate-prices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "event_type": "api_call",
  "record": {
    "id": "D32NAA8",
    "durationInMs": 32,
    "isVerified": true
  },
  "customer_id": "cus_CrqwefTRWBWRT",
  "timestamp": "2024-12-20T16:04:11Z"
}
'
{
  "id": "cal_1234567890",
  "result": [
    {
      "product_id": "itm_AweveQEoewer",
      "amount_excluding_tax": 10000,
      "currency": "EUR",
      "customer_id": "<string>",
      "subscription_id": "<string>",
      "price_group": {
        "id": "grp_QalW2vTAdkR6IY",
        "name": "mastercard"
      },
      "tax_amount": 2000,
      "total_amount": 12000
    }
  ]
}

Autorisations

​
Authorization
string
header
requis

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

Paramètres de requête

​
product_id
string

Hyperline ID of the product.

Exemple:

"itm_AweveQEoewer"

​
subscription_id
string

Hyperline ID of the subscription.

Exemple:

"sub_QalW2vTAdkR6IY"

​
include_tax
boolean | null

Whether to include amounts with tax

Exemple:

true

Corps

application/json

Event payload

​
event_type
string
requis

Type corresponding to the event. When creating a dynamic product, this type will be used to map the related events to specific prices.

Minimum string length: 1
Exemple:

"api_call"

​
record
object
requis

Payload of the event containing an ID and any additional metadata.

Exemple:
{
  "id": "D32NAA8",
  "durationInMs": 32,
  "isVerified": true
}
​
customer_id
string

Hyperline ID or external ID of the existing customer.

Exemple:

"cus_CrqwefTRWBWRT"

​
timestamp
string<date-time>

UTC date time string in the ISO 8601 format, or milliseconds since the epoch. The event timestamp is used to retrieve the events related to a specific billing period.

Exemple:

"2024-12-20T16:04:11Z"

Réponse

200 - application/json

Event prices simulated

​
id
string
requis

ID of the calculation.

Exemple:

"cal_1234567890"

​
result
object[]
requis