Get the rate schedule for a contract
curl --request POST \
--url https://api.metronome.com/v1/contracts/getContractRateSchedule \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"customer_id": "13117714-3f05-48e5-a6e9-a66093f13b4d",
"contract_id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
"at": "2020-01-01T00:00:00.000Z",
"selectors": [
{
"product_id": "d6300dbb-882e-4d2d-8dec-5125d16b65d0",
"partial_pricing_group_values": {
"region": "us-west-2",
"cloud": "aws"
}
}
]
}
'import requests
url = "https://api.metronome.com/v1/contracts/getContractRateSchedule"
payload = {
"customer_id": "13117714-3f05-48e5-a6e9-a66093f13b4d",
"contract_id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
"at": "2020-01-01T00:00:00.000Z",
"selectors": [
{
"product_id": "d6300dbb-882e-4d2d-8dec-5125d16b65d0",
"partial_pricing_group_values": {
"region": "us-west-2",
"cloud": "aws"
}
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
customer_id: '13117714-3f05-48e5-a6e9-a66093f13b4d',
contract_id: 'd7abd0cd-4ae9-4db7-8676-e986a4ebd8dc',
at: '2020-01-01T00:00:00.000Z',
selectors: [
{
product_id: 'd6300dbb-882e-4d2d-8dec-5125d16b65d0',
partial_pricing_group_values: {region: 'us-west-2', cloud: 'aws'}
}
]
})
};
fetch('https://api.metronome.com/v1/contracts/getContractRateSchedule', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.metronome.com/v1/contracts/getContractRateSchedule",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'customer_id' => '13117714-3f05-48e5-a6e9-a66093f13b4d',
'contract_id' => 'd7abd0cd-4ae9-4db7-8676-e986a4ebd8dc',
'at' => '2020-01-01T00:00:00.000Z',
'selectors' => [
[
'product_id' => 'd6300dbb-882e-4d2d-8dec-5125d16b65d0',
'partial_pricing_group_values' => [
'region' => 'us-west-2',
'cloud' => 'aws'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.metronome.com/v1/contracts/getContractRateSchedule"
payload := strings.NewReader("{\n \"customer_id\": \"13117714-3f05-48e5-a6e9-a66093f13b4d\",\n \"contract_id\": \"d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc\",\n \"at\": \"2020-01-01T00:00:00.000Z\",\n \"selectors\": [\n {\n \"product_id\": \"d6300dbb-882e-4d2d-8dec-5125d16b65d0\",\n \"partial_pricing_group_values\": {\n \"region\": \"us-west-2\",\n \"cloud\": \"aws\"\n }\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.metronome.com/v1/contracts/getContractRateSchedule")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"customer_id\": \"13117714-3f05-48e5-a6e9-a66093f13b4d\",\n \"contract_id\": \"d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc\",\n \"at\": \"2020-01-01T00:00:00.000Z\",\n \"selectors\": [\n {\n \"product_id\": \"d6300dbb-882e-4d2d-8dec-5125d16b65d0\",\n \"partial_pricing_group_values\": {\n \"region\": \"us-west-2\",\n \"cloud\": \"aws\"\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.metronome.com/v1/contracts/getContractRateSchedule")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"customer_id\": \"13117714-3f05-48e5-a6e9-a66093f13b4d\",\n \"contract_id\": \"d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc\",\n \"at\": \"2020-01-01T00:00:00.000Z\",\n \"selectors\": [\n {\n \"product_id\": \"d6300dbb-882e-4d2d-8dec-5125d16b65d0\",\n \"partial_pricing_group_values\": {\n \"region\": \"us-west-2\",\n \"cloud\": \"aws\"\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"rate_card_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product_name": "<string>",
"product_tags": [
"<string>"
],
"product_custom_fields": {},
"starting_at": "2023-11-07T05:31:56Z",
"entitled": true,
"list_rate": {
"price": 123,
"tiers": [
{
"price": 123,
"size": 123
}
],
"pricing_group_values": {},
"credit_type": {
"name": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
},
"ending_before": "2023-11-07T05:31:56Z",
"pricing_group_values": {},
"override_rate": {
"price": 123,
"tiers": [
{
"price": 123,
"size": 123
}
],
"pricing_group_values": {},
"credit_type": {
"name": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
},
"commit_rate": {
"price": 123,
"tiers": [
{
"price": 123,
"size": 123
}
]
}
}
],
"next_page": "<string>"
}Contracts
Get the rate schedule for a contract
For a specific customer and contract, get the rates at a specific point in time. This endpoint takes the contract’s rate card into consideration, including scheduled changes. It also takes into account overrides on the contract.
For example, if you want to show your customer a summary of the prices they are paying, inclusive of any negotiated discounts or promotions, use this endpoint. This endpoint only returns rates that are entitled.
POST
/
v1
/
contracts
/
getContractRateSchedule
Get the rate schedule for a contract
curl --request POST \
--url https://api.metronome.com/v1/contracts/getContractRateSchedule \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"customer_id": "13117714-3f05-48e5-a6e9-a66093f13b4d",
"contract_id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
"at": "2020-01-01T00:00:00.000Z",
"selectors": [
{
"product_id": "d6300dbb-882e-4d2d-8dec-5125d16b65d0",
"partial_pricing_group_values": {
"region": "us-west-2",
"cloud": "aws"
}
}
]
}
'import requests
url = "https://api.metronome.com/v1/contracts/getContractRateSchedule"
payload = {
"customer_id": "13117714-3f05-48e5-a6e9-a66093f13b4d",
"contract_id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
"at": "2020-01-01T00:00:00.000Z",
"selectors": [
{
"product_id": "d6300dbb-882e-4d2d-8dec-5125d16b65d0",
"partial_pricing_group_values": {
"region": "us-west-2",
"cloud": "aws"
}
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
customer_id: '13117714-3f05-48e5-a6e9-a66093f13b4d',
contract_id: 'd7abd0cd-4ae9-4db7-8676-e986a4ebd8dc',
at: '2020-01-01T00:00:00.000Z',
selectors: [
{
product_id: 'd6300dbb-882e-4d2d-8dec-5125d16b65d0',
partial_pricing_group_values: {region: 'us-west-2', cloud: 'aws'}
}
]
})
};
fetch('https://api.metronome.com/v1/contracts/getContractRateSchedule', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.metronome.com/v1/contracts/getContractRateSchedule",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'customer_id' => '13117714-3f05-48e5-a6e9-a66093f13b4d',
'contract_id' => 'd7abd0cd-4ae9-4db7-8676-e986a4ebd8dc',
'at' => '2020-01-01T00:00:00.000Z',
'selectors' => [
[
'product_id' => 'd6300dbb-882e-4d2d-8dec-5125d16b65d0',
'partial_pricing_group_values' => [
'region' => 'us-west-2',
'cloud' => 'aws'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.metronome.com/v1/contracts/getContractRateSchedule"
payload := strings.NewReader("{\n \"customer_id\": \"13117714-3f05-48e5-a6e9-a66093f13b4d\",\n \"contract_id\": \"d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc\",\n \"at\": \"2020-01-01T00:00:00.000Z\",\n \"selectors\": [\n {\n \"product_id\": \"d6300dbb-882e-4d2d-8dec-5125d16b65d0\",\n \"partial_pricing_group_values\": {\n \"region\": \"us-west-2\",\n \"cloud\": \"aws\"\n }\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.metronome.com/v1/contracts/getContractRateSchedule")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"customer_id\": \"13117714-3f05-48e5-a6e9-a66093f13b4d\",\n \"contract_id\": \"d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc\",\n \"at\": \"2020-01-01T00:00:00.000Z\",\n \"selectors\": [\n {\n \"product_id\": \"d6300dbb-882e-4d2d-8dec-5125d16b65d0\",\n \"partial_pricing_group_values\": {\n \"region\": \"us-west-2\",\n \"cloud\": \"aws\"\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.metronome.com/v1/contracts/getContractRateSchedule")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"customer_id\": \"13117714-3f05-48e5-a6e9-a66093f13b4d\",\n \"contract_id\": \"d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc\",\n \"at\": \"2020-01-01T00:00:00.000Z\",\n \"selectors\": [\n {\n \"product_id\": \"d6300dbb-882e-4d2d-8dec-5125d16b65d0\",\n \"partial_pricing_group_values\": {\n \"region\": \"us-west-2\",\n \"cloud\": \"aws\"\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"rate_card_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product_name": "<string>",
"product_tags": [
"<string>"
],
"product_custom_fields": {},
"starting_at": "2023-11-07T05:31:56Z",
"entitled": true,
"list_rate": {
"price": 123,
"tiers": [
{
"price": 123,
"size": 123
}
],
"pricing_group_values": {},
"credit_type": {
"name": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
},
"ending_before": "2023-11-07T05:31:56Z",
"pricing_group_values": {},
"override_rate": {
"price": 123,
"tiers": [
{
"price": 123,
"size": 123
}
],
"pricing_group_values": {},
"credit_type": {
"name": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
},
"commit_rate": {
"price": 123,
"tiers": [
{
"price": 123,
"size": 123
}
]
}
}
],
"next_page": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Max number of results that should be returned
Required range:
1 <= x <= 100Cursor that indicates where the next page of results should start.
Body
application/json
Contract rate schedule filter options.
ID of the customer for whose contract to get the rate schedule for.
ID of the contract to get the rate schedule for.
optional timestamp which overlaps with the returned rate schedule segments. When not specified, the current timestamp will be used.
List of rate selectors, rates matching ANY of the selectors will be included in the response. Passing no selectors will result in all rates being returned.
Show child attributes
Show child attributes
⌘I