Skip to content
Leapa
Leapa.co
Sign in

Create new Rates

Create a new Rates

POST https://api.leapa.co/v2/rates

This endpoint needs your API key

Send it as a bearer token in the Authorization header. A request without one is answered with 401. See Authentication for where to find your key and how to keep it secret.

Request

curl -X POST "https://api.leapa.co/v2/rates" \
  -H "Authorization: Bearer $LEAPA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jeanne Ndayishimiye",
    "code": "string",
    "type": "time",
    "days": [
      "monday"
    ],
    "amount": 45000,
    "description": "Room 204, two nights",
    "from_date": "2026-01-31",
    "to_date": "2026-01-31",
    "time_limit": "sameDay",
    "amount_limit": 45000
  }'

Response

Created

{
  "id": "obj_5f21c8a40b",
  "name": "Jeanne Ndayishimiye",
  "code": "string",
  "type": "time",
  "days": [
    "monday"
  ],
  "amount": 45000,
  "description": "Room 204, two nights",
  "from_date": 0,
  "to_date": 0,
  "amount_limit": 45000,
  "created_date": 0
}

Request body

application/json

Required. Send it as JSON.

  • namestringrequired

    Rate Name

  • codestringrequired

    Code of the Rate. Constraints: Not null, Size(min=3, max=20)

    Must be:3 to 20 characters
  • typestringrequired

    Rates Type

    Allowed values:timeamountLimit
  • daysarray of stringrequired

    Week Days

  • amountnumber<double>required

    Rate amount

  • descriptionstring

    Descrition of the Rates

  • from_datestring<date>

    From date for time based rates, format(YYYY-MM-DD)

  • to_datestring<date>

    To date for time based rates, format(YYYY-MM-DD)

  • time_limitstringrequired

    Time Limit Type

    Allowed values:sameDaysameWeeksameMonth
  • amount_limitinteger<int64>

    Amount limit used for the Amount based Rate.

Response

application/json
  • idstring

    Rate ID

  • namestring

    Rate Name

  • codestring

    Rate Code

  • typestring

    Rates Type

    Allowed values:timeamountLimit
  • daysarray of string

    Week Days

  • amountnumber<double>required

    It is a percentage amount ?

  • descriptionstring

    Descrition of the Rates

  • from_dateinteger<int64>

    From date for time based rates

  • to_dateinteger<int64>

    To date for time based rates

  • amount_limitinteger<int64>required

    Amount limit used for the Amount based Rate,

  • created_dateinteger<int64>

    Rates creation time

Status codes

  • 201Created
  • 400Bad request
  • 401Unauthorized
  • 402Payment required
  • 403Forbidden
  • 404Not found
  • 428Precondition required
  • 500Server error

Request

curl -X POST "https://api.leapa.co/v2/rates" \
  -H "Authorization: Bearer $LEAPA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jeanne Ndayishimiye",
    "code": "string",
    "type": "time",
    "days": [
      "monday"
    ],
    "amount": 45000,
    "description": "Room 204, two nights",
    "from_date": "2026-01-31",
    "to_date": "2026-01-31",
    "time_limit": "sameDay",
    "amount_limit": 45000
  }'

Response

Created

{
  "id": "obj_5f21c8a40b",
  "name": "Jeanne Ndayishimiye",
  "code": "string",
  "type": "time",
  "days": [
    "monday"
  ],
  "amount": 45000,
  "description": "Room 204, two nights",
  "from_date": 0,
  "to_date": 0,
  "amount_limit": 45000,
  "created_date": 0
}