Business Search - how to locate a business and retrieve the filing PDF for a single filing

1

Here are the steps one would take in order to complete this.

  1. Search for a business using Business Search Facets - GET /businesses/search/facets
  2. Pay for the BUSINESS_SUMMARY_FILING_HISTORY docs - POST /businesses/{{identifier}}/documents/requests
  3. Retrieve all of the filings for that business using Businesses Filings - GET /businesses/{{identifier}}/filings
  4. Review the response, noting the filing ID and filing name of the filing you’re interested in.
  5. Using the Business Search API once again, call this to fetch the PDF for 1 filing - GET /businesses/{identifier}/documents/filings/{filing_id}/{filing_name}

Please follow along with the postman collection as it fills in key parameters for you if you follow this sequence.

1 Like
2

Hi @jlane ,
I followed the steps and I receieved the error below. I have blocked the account ID for security purposes. Thank you.

image
image1837×948 91.3 KB

3

Hi @bhargavi.kallakuri . I missed a step initially, but I have edited the original topic. I forgot to include the step where you pay for the summary and filings; this is required to pull down the filings PDF.

Please give that a try and let me know if you’re still getting the authorization error.

4

Hi @jlane,

Can you please share a screenshot for step 2? Are you suggesting me to follow the process on
Postman
or
https://bcregistry-demo.apigee.io/docs/businessproxy/1/overview

I don’t see “POST /businesses/{{identifier}}/documents/requests” on the developer site and I tried step 2 on postman with the following details and received an error.

EndPoint :{{base_url}}/{{version}}/businesses/{{identifier}}/documents/requests

Request
{
“documentAccessRequest”:{
“documents”: [
{
“type”: “BUSINESS_SUMMARY_FILING_HISTORY”
}
]
}
}

Response
{
“errorMessage”: “API backend third party service error.”,
“rootCause”: "message:[error:Document Access Request can be created only by a premium account user] "
}

5

Hello @bhargavi.kallakuri. Sorry for the confusing naming.
The POST to pay for the summary is described here:
https://bcregistry-demo.apigee.io/docs/regsearchproxy/1/routes/businesses/{identifier}/requests/post

Then, in the postman collection, note that the account ID in the header for that POST call is static instead of being a variable so you will need to update that to be your account.

Here are the headers - make sure your account ID is used:
image

Here’s the body. Note that businessName has been added, but is optional (will be updated in specs shortly)
image

6

Hi John ,
I have followed your updated steps and I am receiving the following error at step 2. Please help.

image
image1477×850 51 KB

7

Hello. can you please confirm that your account id is present in the headers when you made that call?

8

Yes John . My account ID and key was also present.

9

Good Morning @jlane ,
Did you have a chance to look into this?

10

Hello @bhargavi.kallakuri I am unable to reproduce your issue. If you were given an API key then your account is definitely premium, and you have stated that you entered your account ID as a parameter as well.

Can you please retry these steps in sequence with a new business just as a a sanity check against errors or omissions. Please post your calls/responses here if possible or via email is it’s easier to format.

11

Hi John .I repeated the steps but getting the same error at step 2. May be we should try to resolve it over a call .