Skip to main content
POST
/
api
/
v2
/
billing
/
billingPeriod
Start a new billing period for an organization
curl --request POST \
  --url 'https://api.vida.dev/api/v2/billing/billingPeriod?token=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "startDateTimestamp": 1735689600,
  "endDateTimestamp": 1738281600
}
'
{
  "success": true,
  "message": "Billing period updated",
  "billingPeriod": {
    "startDateTimestamp": 1735689600,
    "endDateTimestamp": 1738281600
  }
}

Authorizations

​
token
string
query
required

Vida API Token

Query Parameters

​
targetAccountId
string

Account ID to update billing period for

​
externalAccountId
string

External account identifier mapped to the target account

Body

application/json
​
startDateTimestamp
integer
required

Billing period start timestamp (seconds since epoch)

Example:

1735689600

​
endDateTimestamp
integer
required

Billing period end timestamp (seconds since epoch)

Example:

1738281600

Response

Billing period updated

​
success
boolean
Example:

true

​
message
string
Example:

"Billing period updated"

​
billingPeriod
object