curl --request POST \
--url https://api.bigdata.com/v1/fixed-income/corporate/isin/query \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"identifier": {
"type": "isin",
"value": [
"US037833EQ92",
"US404280DT33"
]
}
}
'import requests
url = "https://api.bigdata.com/v1/fixed-income/corporate/isin/query"
payload = { "identifier": {
"type": "isin",
"value": ["US037833EQ92", "US404280DT33"]
} }
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({identifier: {type: 'isin', value: ['US037833EQ92', 'US404280DT33']}})
};
fetch('https://api.bigdata.com/v1/fixed-income/corporate/isin/query', 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.bigdata.com/v1/fixed-income/corporate/isin/query",
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([
'identifier' => [
'type' => 'isin',
'value' => [
'US037833EQ92',
'US404280DT33'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$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.bigdata.com/v1/fixed-income/corporate/isin/query"
payload := strings.NewReader("{\n \"identifier\": {\n \"type\": \"isin\",\n \"value\": [\n \"US037833EQ92\",\n \"US404280DT33\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
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.bigdata.com/v1/fixed-income/corporate/isin/query")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"identifier\": {\n \"type\": \"isin\",\n \"value\": [\n \"US037833EQ92\",\n \"US404280DT33\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bigdata.com/v1/fixed-income/corporate/isin/query")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"identifier\": {\n \"type\": \"isin\",\n \"value\": [\n \"US037833EQ92\",\n \"US404280DT33\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"results": {
"US037833EQ92": {
"issuer_name": "Apple Inc",
"issuer_rp_entity_id": "D8442A",
"description": "3.95% NT REDEEM 08/08/2052 USD 2000",
"issue_date": "2022-08-08",
"maturity_date": "2052-08-08",
"coupon": 3.95,
"interest_payment_frequency": "semi-annual",
"currency": "USD",
"issue_amount_mm": 1750,
"outstanding_amount_mm": 1750,
"rank": "senior",
"status": "active",
"bond_type": "note",
"is_callable": true,
"is_secured": false,
"is_guaranteed": true
}
},
"errors": [
{
"message": "<string>"
}
],
"metadata": {
"request_id": "<string>",
"timestamp": "<string>"
},
"sources": [
{
"id": "CA9FA3",
"name": "Corporate Fundamentals"
}
],
"usage": {}
}{
"message": "Bad Request Error",
"statusCode": 400
}{
"message": "Too many requests. Please try again later.",
"statusCode": 429
}{
"message": "Internal Server Error",
"statusCode": 500
}Bonds by ISIN
This endpoint is in Beta. Access must be requested before you can use it: contact support@bigdata.com to join the Beta program.
Returns bonds and their terms by the bonds’ ISINs, one or up to 50 per request:
description, issuer, issue and maturity dates, coupon and payment frequency,
currency, issued and outstanding amounts, seniority, status and structural features.
results is keyed by ISIN, one key per distinct ISIN sent in the order sent, and an
ISIN with no bond available is keyed to null. The issuer’s RavenPack entity
identifier is absent when the issuer has none.
curl --request POST \
--url https://api.bigdata.com/v1/fixed-income/corporate/isin/query \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"identifier": {
"type": "isin",
"value": [
"US037833EQ92",
"US404280DT33"
]
}
}
'import requests
url = "https://api.bigdata.com/v1/fixed-income/corporate/isin/query"
payload = { "identifier": {
"type": "isin",
"value": ["US037833EQ92", "US404280DT33"]
} }
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({identifier: {type: 'isin', value: ['US037833EQ92', 'US404280DT33']}})
};
fetch('https://api.bigdata.com/v1/fixed-income/corporate/isin/query', 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.bigdata.com/v1/fixed-income/corporate/isin/query",
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([
'identifier' => [
'type' => 'isin',
'value' => [
'US037833EQ92',
'US404280DT33'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$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.bigdata.com/v1/fixed-income/corporate/isin/query"
payload := strings.NewReader("{\n \"identifier\": {\n \"type\": \"isin\",\n \"value\": [\n \"US037833EQ92\",\n \"US404280DT33\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
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.bigdata.com/v1/fixed-income/corporate/isin/query")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"identifier\": {\n \"type\": \"isin\",\n \"value\": [\n \"US037833EQ92\",\n \"US404280DT33\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bigdata.com/v1/fixed-income/corporate/isin/query")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"identifier\": {\n \"type\": \"isin\",\n \"value\": [\n \"US037833EQ92\",\n \"US404280DT33\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"results": {
"US037833EQ92": {
"issuer_name": "Apple Inc",
"issuer_rp_entity_id": "D8442A",
"description": "3.95% NT REDEEM 08/08/2052 USD 2000",
"issue_date": "2022-08-08",
"maturity_date": "2052-08-08",
"coupon": 3.95,
"interest_payment_frequency": "semi-annual",
"currency": "USD",
"issue_amount_mm": 1750,
"outstanding_amount_mm": 1750,
"rank": "senior",
"status": "active",
"bond_type": "note",
"is_callable": true,
"is_secured": false,
"is_guaranteed": true
}
},
"errors": [
{
"message": "<string>"
}
],
"metadata": {
"request_id": "<string>",
"timestamp": "<string>"
},
"sources": [
{
"id": "CA9FA3",
"name": "Corporate Fundamentals"
}
],
"usage": {}
}{
"message": "Bad Request Error",
"statusCode": 400
}{
"message": "Too many requests. Please try again later.",
"statusCode": 429
}{
"message": "Internal Server Error",
"statusCode": 500
}Authorizations
Body
The bonds to return, named by their ISINs.
Show child attributes
Show child attributes
Response
Successful Response
The bonds keyed by ISIN: one key per distinct ISIN sent, upper-cased, in the order they were sent. The value is null when no bond is available for that ISIN.
Show child attributes
Show child attributes
{
"US037833EQ92": {
"issuer_name": "Apple Inc",
"issuer_rp_entity_id": "D8442A",
"description": "3.95% NT REDEEM 08/08/2052 USD 2000",
"issue_date": "2022-08-08",
"maturity_date": "2052-08-08",
"coupon": 3.95,
"interest_payment_frequency": "semi-annual",
"currency": "USD",
"issue_amount_mm": 1750,
"outstanding_amount_mm": 1750,
"rank": "senior",
"status": "active",
"bond_type": "note",
"is_callable": true,
"is_secured": false,
"is_guaranteed": true
}
}
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Structured-data sources the response was built from, one entry per source. Empty when no catalog source contributed.
Show child attributes
Show child attributes
Tokens the request consumed, per content tier. Returned only to callers billed in tokens.
Show child attributes
Show child attributes
Was this page helpful?