{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-country-apis-catalog/product-catalog/se/getSignatory/sidebars.yaml","current-catalog-info":"current-catalog-info-/country-apis-catalog/product-catalog/se/getsignatory/openapi"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Requests and Responses","llmstxt":{"hide":true}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"requests-and-responses","__idx":0},"children":["Requests and Responses"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":1},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To retrieve the authorized signatory for a specific company, you must first authenticate your user account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Please refer to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/country-apis-catalog/product-catalog/se/authenticate"},"children":["Authenticate API documentation"]}," for details on how to authenticate and obtain a token."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note that this step differs from earlier versions of the GetSignatory REST API. The generated token can be used across all Creditsafe Sweden REST APIs including DateCheck, GetData, SearchEngine, GetSignatory, GetUnitData, and SPAR."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"production-urls","__idx":2},"children":["Production URLs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GetSignatory Endpoint:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"https://se-webservice.apps.creditsafe.com/getsignatory\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Health Check:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"https://se-webservice.apps.creditsafe.com/getsignatory/health\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-methods","__idx":3},"children":["Request Methods"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The GetSignatory REST API uses a single ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET"]}," method to retrieve the company's authorized signatories."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"getsignatory-request","__idx":4},"children":["GetSignatory Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /getsignatory\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example Request:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"HEADER: Authorization: Bearer <token>\nURL: https://se-webservice.apps.creditsafe.com/getsignatory?searchnumber=5565144408&transactionid=X123\nMethod: GET\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-parameters","__idx":5},"children":["Request Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The table below describes each parameter included in the requests."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Data type"},"children":["Data type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Max length"},"children":["Max length"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["searchnumber"]}," (query)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["10"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Organization number (10 digits)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transactionid"]}," (query)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["14"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer's internal information (customer/invoice number). Recommended to use this field as it can be helpful in tracking your call in Creditsafe logs"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["language"]}," (query)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sets the language of the response. For this service it is only affecting error responses. Available languages: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sv"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Sandbox Parameter Behavior"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the sandbox version of this API, only the parameters ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchnumber"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionid"]}," are actively supported. All other parameters included in the request will be ignored without error or warning."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Developers are encouraged to structure their requests as they would in a production environment, including all expected parameters. This ensures consistency and simplifies the transition to production usage. However, it is important to understand that in sandbox mode, unsupported parameters will not influence the response and should not be relied upon for testing behavior or data validation."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-successful","__idx":6},"children":["Response (Successful)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response contains a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metaData"]}," object with request information and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report"]}," object with the company's signatory information."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"http-response-code-200-ok","__idx":7},"children":["HTTP Response code: 200 OK"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"metaData\": {\n    \"apiLogId\": 542900,\n    \"timeStamp\": \"2026-07-15T14:26:33\",\n    \"resource\": \"GetSignatory (1227)\",\n    \"method\": \"GET\",\n    \"requestUrl\": \"https://se-webservice.apps.creditsafe.com/getsignatory?searchnumber=5565144408\"\n  },\n  \"report\": {\n    \"companyId\": \"5566443388\",\n    \"coverage\": \"complete\",\n    \"adminSign\": [\n      [\n        {\n          \"name\": \"Testersson, Karl\",\n          \"positions\": [\n            { \n              \"roleCode\": 5, \n              \"roleName\": \"Ledamot\" \n            },\n            { \n              \"roleCode\": 12, \n              \"roleName\": \"Verkställande direktör\" \n            }\n          ],\n          \"personalNumber\": \"198208161212\"\n        }\n      ]\n    ],\n    \"combinations\": [\n      [\n        {\n          \"name\": \"Testersson, Karl\",\n          \"positions\": [\n            { \n              \"roleCode\": 5, \n              \"roleName\": \"Ledamot\" \n              },\n            { \n              \"roleCode\": 12, \n              \"roleName\": \"Verkställande direktör\" \n            }\n          ],\n          \"personalNumber\": \"198208161212\"\n        }\n      ]\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-parameters","__idx":8},"children":["Response Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response contains two main sections:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"metadata","__idx":9},"children":["metaData"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metaData"]}," object contains request information for tracing and troubleshooting:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Data type"},"children":["Data type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["apiLogId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique identifier for the Creditsafe API log. Refer to this ID when contacting support"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["timeStamp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DateTime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The exact time when the request was processed by Creditsafe. Format: YYYY-MM-DDTHH:MM:SS"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["resource"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates which service delivered the report"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["method"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the HTTP method used for the request"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["requestUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The complete URL of the request sent to Creditsafe"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"report","__idx":10},"children":["report"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report"]}," object contains the company's signatory information:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Data type"},"children":["Data type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["companyId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The company's organization number as sent in the request (digits only)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["coverage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies if all combinations could be identified. Available values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complete"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partial"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["none"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["adminSign"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Persons allowed to sign for the company only in administrative matters. Contains arrays of signing combinations"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["combinations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Possible signing combinations (max 5,000). Contains arrays of signing combinations"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"signatory-person-parameters","__idx":11},"children":["Signatory Person Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For each person in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adminSign"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["combinations"]}," arrays:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Data type"},"children":["Data type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name of the signatory"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["positions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Function(s) of the signatory. Contains objects with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["roleCode"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["roleName"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["personalNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Person number of signatory"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Null Values"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Parameters with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," value are hidden in the responses of Creditsafe's REST APIs."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understanding-the-response","__idx":12},"children":["Understanding the Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The GetSignatory API provides detailed information about who is authorized to sign for a company:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Coverage indicator"]}," - Shows whether all signing combinations were successfully identified"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Administrative signatories"]}," - The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adminSign"]}," array lists persons who can sign only for administrative matters"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Signing combinations"]}," - The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["combinations"]}," array shows all possible ways the company can be legally bound (max 5,000 combinations)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Multiple roles"]}," - A single person can have multiple positions/roles, shown in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["positions"]}," array"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Role codes"]}," - Each position includes both a numeric ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["roleCode"]}," and descriptive ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["roleName"]}," in Swedish"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this information to understand signing authority and validate who can legally commit the company to agreements."]}]},"headings":[{"value":"Requests and Responses","id":"requests-and-responses","depth":1},{"value":"Authentication","id":"authentication","depth":2},{"value":"Production URLs","id":"production-urls","depth":2},{"value":"Request Methods","id":"request-methods","depth":2},{"value":"GetSignatory Request","id":"getsignatory-request","depth":3},{"value":"Request Parameters","id":"request-parameters","depth":2},{"value":"Response (Successful)","id":"response-successful","depth":2},{"value":"HTTP Response code: 200 OK","id":"http-response-code-200-ok","depth":3},{"value":"Response Parameters","id":"response-parameters","depth":2},{"value":"metaData","id":"metadata","depth":3},{"value":"report","id":"report","depth":3},{"value":"Signatory Person Parameters","id":"signatory-person-parameters","depth":3},{"value":"Understanding the Response","id":"understanding-the-response","depth":2}],"frontmatter":{"seo":{"title":"Requests and Responses"}},"lastModified":"2026-07-17T12:34:52.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/country-apis-catalog/product-catalog/se/getsignatory/documentation/requestresponse","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}