Bonds by Issuer

curl --request POST \
  --url https://api.bigdata.com/v1/fixed-income/corporate/issuer/query \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "identifier": {
    "type": "rp_entity_id",
    "value": "D8442A"
  },
  "status": "active"
}
'

import requests

url = "https://api.bigdata.com/v1/fixed-income/corporate/issuer/query"

payload = {
    "identifier": {
        "type": "rp_entity_id",
        "value": "D8442A"
    },
    "status": "active"
}
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: 'rp_entity_id', value: 'D8442A'}, status: 'active'})
};

fetch('https://api.bigdata.com/v1/fixed-income/corporate/issuer/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/issuer/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' => 'rp_entity_id',
        'value' => 'D8442A'
    ],
    'status' => 'active'
  ]),
  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/issuer/query"

	payload := strings.NewReader("{\n  \"identifier\": {\n    \"type\": \"rp_entity_id\",\n    \"value\": \"D8442A\"\n  },\n  \"status\": \"active\"\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/issuer/query")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"identifier\": {\n    \"type\": \"rp_entity_id\",\n    \"value\": \"D8442A\"\n  },\n  \"status\": \"active\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bigdata.com/v1/fixed-income/corporate/issuer/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\": \"rp_entity_id\",\n    \"value\": \"D8442A\"\n  },\n  \"status\": \"active\"\n}"

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "isin": "US037833EQ92",
      "issuer_rp_entity_id": "D8442A",
      "issuer_name": "Apple Inc",
      "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>"
  },
  "pagination": {
    "cursor": "00000DexaRK4NT6t",
    "has_cursor": true
  },
  "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 Issuer

Returns the bonds a company has issued, with their terms: ISIN, description, issue and maturity dates, coupon and payment frequency, currency, issued and outstanding amounts, seniority (rank), status and structural features. Only active bonds are returned unless status asks for inactive or defaulted ones, or is null for every status. Results are paged: send back pagination.cursor to get the next page. A page can hold fewer bonds than the next one, or none, while has_cursor is still true.

POST

fixed-income

corporate

issuer

query

Bonds by Issuer

curl --request POST \
  --url https://api.bigdata.com/v1/fixed-income/corporate/issuer/query \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "identifier": {
    "type": "rp_entity_id",
    "value": "D8442A"
  },
  "status": "active"
}
'

import requests

url = "https://api.bigdata.com/v1/fixed-income/corporate/issuer/query"

payload = {
    "identifier": {
        "type": "rp_entity_id",
        "value": "D8442A"
    },
    "status": "active"
}
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: 'rp_entity_id', value: 'D8442A'}, status: 'active'})
};

fetch('https://api.bigdata.com/v1/fixed-income/corporate/issuer/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/issuer/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' => 'rp_entity_id',
        'value' => 'D8442A'
    ],
    'status' => 'active'
  ]),
  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/issuer/query"

	payload := strings.NewReader("{\n  \"identifier\": {\n    \"type\": \"rp_entity_id\",\n    \"value\": \"D8442A\"\n  },\n  \"status\": \"active\"\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/issuer/query")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"identifier\": {\n    \"type\": \"rp_entity_id\",\n    \"value\": \"D8442A\"\n  },\n  \"status\": \"active\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bigdata.com/v1/fixed-income/corporate/issuer/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\": \"rp_entity_id\",\n    \"value\": \"D8442A\"\n  },\n  \"status\": \"active\"\n}"

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "isin": "US037833EQ92",
      "issuer_rp_entity_id": "D8442A",
      "issuer_name": "Apple Inc",
      "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>"
  },
  "pagination": {
    "cursor": "00000DexaRK4NT6t",
    "has_cursor": true
  },
  "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

SingleIdentifier · object

required

Object specifying which identifier you are using to request the bonds the company has issued. You must supply one type and its corresponding value.

Show child attributes

status

enum<string> | null

default:active

Only return bonds in this status: 'active', 'inactive' or 'defaulted'. Defaults to 'active'; send null to return bonds in every status.

Available options:

active,

inactive,

defaulted

Example:

"active"

cursor

string | null

Token for the next page. Send back 'pagination.cursor' from the previous response, with the same identifier and status. Omit it for the first page.

Response

Successful Response

results

Bond · object[]

required

The company's bonds on this page. A page can hold fewer bonds than others, or none at all, while more remain: keep requesting the next page with 'cursor' until 'pagination.has_cursor' is false.

Show child attributes

errors

ErrorDetail · object[] | null

Show child attributes

metadata

Metadata · object | null

Show child attributes

pagination

Pagination · object | null

Common pagination response for endpoints that support pagination.

Show child attributes

sources

Source · object[]

The content catalog 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. Present only for API keys billed in tokens.

Show child attributes

API

Knowledge Graph

Search Service

Watchlists

Monitors

Research Service

Content

Structured Data

Subscription

SDK

Bonds by Issuer

Authorizations

Body

Response