Bonds by ISIN

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
}

Fixed Income

Bonds by ISIN

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.

POST

fixed-income

corporate

isin

query

Bonds by ISIN

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

X-API-KEY

string

header

required

Body

application/json

identifier

IsinIdentifier · object

required

The bonds to return, named by their ISINs.

Show child attributes

Response

Successful Response

results

Results · object

required

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

Example:

{
  "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

ErrorDetail · object[] | null

Show child attributes

metadata

StructuredDataMetadata · object | null

Show child attributes

sources

Source · object[] | null

Structured-data sources the response was built from, one entry per source. Empty when no catalog source contributed.

Show child attributes

usage

Usage · object | null

Tokens the request consumed, per content tier. Returned only to callers billed in tokens.

Show child attributes

API

Knowledge Graph

Search Service

Watchlists

Monitors

Research Service

Content

Structured Data

Subscription

SDK

Bonds by ISIN

Authorizations

Body

Response