Please follow the below steps to generate access key/token from your account.
\nGo “My Accounts” and click on “API Access”
\nClick on “Generate” to generate a new API Access Token/Key
\nClick on “Copy” symbol/image to copy the key on clipboard.
\n![](\"https://app.einsearch.com/assets/images/apikey-generation-example.png\")
\n\nTo test the API you will have to either use the Authorization header in postman or simply pass a header “KEY” with your API token as its value .
\nPostman:
\nCurl:
\ncurl --location --request POST 'https://api.einsearch.com/api/TinMatch/validate' --header 'KEY: xxxxxxxxxxxxxxxxx' --header 'Content-Type: application/json' --data-raw '{ \"Tin\":\"987654321\", \"Name\":\"John Doe LLC\"}'
\n\n\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"8282917","collectionId":"57cbd72e-32c7-45d4-af71-72d845f34cad","publishedId":"UVRBn6V5","public":true,"customColor":{"top-bar":"4D55A2","right-sidebar":"303030","highlight":"f8981d"},"publishDate":"2025-09-22T11:04:08.000Z"},"item":[{"name":"Tin Match","id":"cb6939f7-29ef-40ce-8f1e-27f8787c6841","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"KEY"},{"key":"value","value":"NOTE:
\n
We would also need to whitelist the IP address of the system from where you will be making API calls (else you will get an error “IP Address disallowed - 192.168.xxx.xxx”).
Validates the TIN and Name combination against the IRS in real-time. If the IRS is down or unreachable, validation will be performed against our internal database. Please provide the full name, separated by spaces.
e.g. “John Doe”, “Libertydata Inc”, “Glass and Door LLC” , “LARRY KAPOOR”
\n\nTip:
\n
For better matches please try to provide FULL name. Minimum 3 characters are required.
status: Request status will always be \"Success\" unless any errors occur.
\ndata: An object containing validated response code and its description. It could be any of the following TIN Match resoponse codes.
\nSearches the Company name in our database. Optionally, you can specify a state and/or zip code to narrow the search to that particular region.
\n\n\nNote:
\n
This search is classified as a header search, and there is no charge associated with it.
The API performs an exact match of both the state name and the zip code (if provided).
State, City and ZipCode are optional fields but we recommend that you provide these for better results.
status: Request status will always be \"Success\" unless any errors occur.
\nsearchLogID: A unique identifier for each search performed. It is also necessary for the get business details API.
\ndata: An array that contains all matching records. It will be empty if no match is found.
\nSearches the EIN Number in our database. It performs an exact match of the EIN.
\n\n\nNote:
\n
Valid EIN must be of 9 digits.
status: Request status will always be \"Success\" unless any errors occur.
\nsearchLogID: A unique identifier for each search performed. It is also necessary for the get business details API.
\ndata: An array that contains all matching records. It will be empty if no match is found.
\nTo obtain details of a specific business, you need to provide the searchlogid from the previous header search and the companyId of the record you wish to retrieve.
\nstatus: Request status will always be \"Success\" unless any errors occur.
\ndata: An array that contains details of the specified business. It will be empty if no match is found.
\ncompanyId of the business from the previous header search.
\n","type":"text/plain"},"key":"companyId","value":"12345678"},{"description":{"content":"searchLogID of the previous header search.
\n","type":"text/plain"},"key":"searchLogID","value":"590182"}],"variable":[]}},"response":[{"id":"12966f78-1489-4e78-9071-ebd3f2dddee8","name":"EIN Search - Get Business Details","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","description":"Content Type","type":"text"},{"key":"KEY","value":"Searches the Person/Company Name Number in OFAC list. It performs a word match of the given Name.
\nstatus: Request status will always be \"Success\" unless any errors occur.
\ndata: An array that contains all matching records. It will be empty if no match is found.
\n