{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"f7e65129-b46f-40cf-a1a1-b5abc3e510ed","name":"Secure API Documentation","description":"## Overview\n\n**Seven Corners provides the Secure API Service for registered Agents only.**\n\nThe purpose of this API is to provide agents with the tools and resources necessary to maintain and manage certificate and claim information.\n\nThis documentation includes the following Collections:\n\n- [Authentication](#37311470-eaab-4940-b397-2e794ebcde0a) - the endpoint used to retrieve an OAUTH token.\n    \n- [Agent](#c8b74143-020e-47eb-bb98-bcfd52d8d991) - these endpoints provide Agents with agent specific resources, including a certificate search.\n    \n- [Certificate](#250411ac-5589-4ac3-bc56-399fcd60b688) - these endpoints allow Agents to view and manage certificates.\n    \n- [Claim](#079ee0af-af7c-4488-aca8-2c1a09ca410e) - these endpoints are use to view information about an insured's claim.\n    \n- [Enrollment](#db9fba1e-1c5f-4707-8195-2d718d757f01) - these endpoints are used to enroll certificate changes by purchasing the quotes generated from the [Certificate](#250411ac-5589-4ac3-bc56-399fcd60b688) management endpoints.\n    \n\n## **Getting started guide**\n\nTo start using the Secure API Service, you need to be a registered Agent with Seven Corners. Visit our [Developer Portal](https://www.sevencorners.com/developer), if you are interested in becoming an Agent.\n\nAfter registering as an Agent, you will be given a Username and Password that will be used to access the Secure API Service.\n\n- You must use a valid **Username** and **Password** to get an **Authentication Token**. This token is required on all non-anonymous API endpoints. Your Username and Password will be provided by your Account Manager when you become a registered Agent.\n    \n- The API only responds to HTTPS-secured communications. Any requests sent via HTTP will return an HTTP 307 redirect to the corresponding HTTPS resources.\n    \n- The API returns request responses in JSON format.\n    - When an API request returns a handled error, it is sent with a relevant 3xx HTTP status code and a message in the body indicating the reason for the error.\n        \n    - When an API request returns an unhandled error, an UnhandledExceptionResponse is returned with a 500 HTTP status code. The response has a reference ID that can be used to allow for internal troubleshooting of the incident.\n        \n\n## **API Environments**\n\n**`Development API:`**`https://sapi-e50.sevencorners.com/api`\n\n**`Production API:`**`https://sapi.sevencorners.com/api`\n\n## Authentication\n\nThe Seven Corners Secure API uses **OAUTH 2.0** tokenization for authentication.\n\nTo retrieve a session token, follow the instructions in the [Authentication](#37311470-eaab-4940-b397-2e794ebcde0a) collection. Once a token is retrieved, you will need to include the token in an **Authentication** request header on all subsequent requests to the API.\n\n`Authentication: Bearer [Token]`\n\n**Example**:\n\nAfter calling the Authentication endpoint to retrieve token `Abc123`, you will need to include the following request header on subsequent API requests:\n\n`Authentication: Bearer Abc123`\n\n> **Note:** Your actual token will be much larger than `Abc123`. \n  \n\n### Authentication Error Response\n\nIf an Authentication token is missing, malformed, or invalid, you will receive an HTTP 401 Unauthorized response code.\n\n## Authorization\n\nAgents are only able to manage certificates (including claim management) in which the authenticated Agent is the Agent of Record for the certificate. There are two general Roles for Agents:\n\n- General Access - This gives the agent permission to view and manage certificates.\n    \n- Claim Access - This gives the agent permission to view claims on behalf of the insured.\n    \n\n> **Note:** The Agent must have a valid Business Associate Agreement (BAA) on file with Seven Corners in order to receive Claim Access. \n  \n\n### **Need some help?**\n\nFor questions regarding this API, please contact our [API Developer Support](https://mailto:apisupport@sevencorners.com).","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"32951228","team":6036642,"collectionId":"f7e65129-b46f-40cf-a1a1-b5abc3e510ed","publishedId":"2sA2xcaaci","public":true,"publicUrl":"https://developer-sapi.sevencorners.com","privateUrl":"https://go.postman.co/documentation/32951228-f7e65129-b46f-40cf-a1a1-b5abc3e510ed","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":"Secure Api Documentation"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/e71932c6-cdb3-4d5d-a8c8-4eb77a583e00/c2Vjb25kYXJ5LXRpLWxvZ28taG9yaXpvbnRhbC1sZWZ0LWFsaWduLVdISVRFX1JHQi5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/dcb3b81a-5162-4451-becc-876b64afc1db/c2Vjb25kYXJ5LXRpLWxvZ28taG9yaXpvbnRhbC1sZWZ0LWFsaWduLUNPTE9SX1JHQi5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2026-03-24T15:41:58.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"Secure Api Documentation","description":""},"logos":{"logoLight":"https://content.pstmn.io/dcb3b81a-5162-4451-becc-876b64afc1db/c2Vjb25kYXJ5LXRpLWxvZ28taG9yaXpvbnRhbC1sZWZ0LWFsaWduLUNPTE9SX1JHQi5wbmc=","logoDark":"https://content.pstmn.io/e71932c6-cdb3-4d5d-a8c8-4eb77a583e00/c2Vjb25kYXJ5LXRpLWxvZ28taG9yaXpvbnRhbC1sZWZ0LWFsaWduLVdISVRFX1JHQi5wbmc="}},"statusCode":200},"environments":[{"name":"Development","id":"fa56fdb7-25b9-4be7-a0cc-5436313e96ec","owner":"32951228","values":[{"key":"serviceUrl","value":"https://api-e50.sevencorners.com/","enabled":true,"type":"default"},{"key":"secureServiceUrl","value":"https://sapi-e50.sevencorners.com/","enabled":true,"type":"default"},{"key":"clientId","value":"[clientId]","enabled":true,"type":"default"},{"key":"token","value":"[token]","enabled":true,"type":"any"},{"key":"quoteIdentifier","value":"[quoteIdentifier]","enabled":true,"type":"any"},{"key":"purchaseIdentifier","value":"[purchaseIDentifier]","enabled":true,"type":"any"},{"key":"bulkQuoteIdentifier","value":"[bulkQuoteIdentifier]","enabled":true,"type":"any"},{"key":"uploadClientId","value":"[uploadClientId]","enabled":true,"type":"any"},{"key":"refreshToken","value":"[refreshToken]","enabled":true,"type":"any"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/75e9082b53a5b0a98942caffe86b279e2f0652423b09648859d296431ee76fc2","favicon":"https://sevencorners.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Development","value":"32951228-fa56fdb7-25b9-4be7-a0cc-5436313e96ec"}],"canonicalUrl":"https://developer-sapi.sevencorners.com/view/metadata/2sA2xcaaci"}