> ## Documentation Index > Fetch the complete documentation index at: https://docs.turrisfi.com/llms.txt > Use this file to discover all available pages before exploring further. # List Corporate Registration Profiles > The standing corporate facts Turris files with Returns the standing corporate facts Turris files with on your behalf: formation date, domicile state, FEIN, share structure and ownership. One row per entity. An entity that has never been through corporate registration has no profile and is simply absent from the list. We do not synthesise a row of nulls for it — that would be telling you something we do not know. **Ownership never includes dates of birth or residential addresses**, for owners or for their officers. Those are identity data for people who are not the API caller, and no integration question this surface answers needs them. ## Narrowing `downstreamEntityId` returns the profile for one entity. ## OpenAPI ````yaml openapi/v2.json GET /v2/downstream/corporate-registration-profiles openapi: 3.0.0 info: title: Turris Public API description: API for managing insurance compliance data version: 2.0.0 contact: {} servers: - url: https://public.api.live.turrisfi.com description: Production - url: https://public.api.sandbox.turrisfi.com description: Sandbox security: [] tags: [] paths: /v2/downstream/corporate-registration-profiles: get: tags: - downstream/corporate-registrations summary: List corporate registration profiles description: >- Returns the standing corporate facts Turris files with, one row per entity: formation date, share structure and ownership. Narrow to one entity with downstreamEntityId. An entity that has never been through corporate registration has no profile and is simply absent. Ownership never includes dates of birth or residential addresses. operationId: CorporateRegistrationsController_getProfiles_v2 parameters: - name: page required: false in: query description: 1-based page number schema: minimum: 1 default: 1 example: 1 type: number - name: limit required: false in: query description: Page size (max 100) schema: minimum: 1 maximum: 100 default: 50 example: 50 type: number - name: downstreamEntityId required: false in: query description: >- Narrow the results to a single entity in your organization. Defaults to your whole subtree (your entity plus every branch beneath it). Returns 404 if the id is not in your subtree. schema: example: 6610b3d2c2e0a51b8c0d1f02 type: string responses: '200': description: A page of profiles content: application/json: schema: type: object properties: data: type: object properties: items: type: array items: $ref: >- #/components/schemas/DownstreamCorporateRegistrationProfileResponse total: type: integer description: Total rows matching the query across all pages example: 137 page: type: integer description: 1-based page number example: 1 limit: type: integer description: Page size example: 50 totalPages: type: integer description: Number of pages, or 0 when there are no rows example: 3 required: - items - total - page - limit - totalPages requestId: type: string description: Unique request identifier example: dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8 timestamp: type: string description: Response timestamp example: '2025-11-12T20:49:03.293Z' required: - data - requestId - timestamp '400': description: Invalid query parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponseDto' '401': description: Invalid or missing auth token content: application/json: schema: $ref: '#/components/schemas/ErrorResponseDto' '403': description: Your organization is not entitled to the public API content: application/json: schema: $ref: '#/components/schemas/ErrorResponseDto' '404': description: downstreamEntityId is not in your organization content: application/json: schema: $ref: '#/components/schemas/ErrorResponseDto' components: schemas: DownstreamCorporateRegistrationProfileResponse: type: object properties: downstreamEntityId: type: string description: Which of your entities this profile describes example: 6610b3d2c2e0a51b8c0d1f02 domicileStateCode: type: string description: The state the entity is domiciled in example: PA fein: type: string description: Federal Employer Identification Number example: 12-3456789 physicalAddress: description: Physical address allOf: - $ref: '#/components/schemas/CorporateRegistrationAddressResponse' mailingAddress: description: Mailing address allOf: - $ref: '#/components/schemas/CorporateRegistrationAddressResponse' dateOfFormation: type: string description: ISO 8601 date of formation example: '2015-06-01T00:00:00.000Z' isIncorporated: type: boolean description: Whether the entity is incorporated example: true authorizedShares: type: number description: Authorized shares example: 1000 parValue: type: number description: Par value per share example: 0.01 ownership: description: >- Ownership, without natural-person dates of birth or residential addresses type: array items: $ref: '#/components/schemas/CorporateRegistrationOwnerResponse' createdAt: type: string description: ISO 8601 creation timestamp example: '2025-01-15T10:30:00.000Z' updatedAt: type: string description: ISO 8601 last-update timestamp example: '2026-02-12T09:00:00.000Z' required: - downstreamEntityId - domicileStateCode - isIncorporated - ownership ErrorResponseDto: type: object properties: statusCode: type: number description: HTTP status code requestId: type: string description: Unique request identifier for debugging errorType: type: string description: >- Machine-readable error classification. Branch on this rather than on `errorMessage`, which is prose and may change. Authentication failures returned by our identity provider are forwarded verbatim, so a 401 can carry a code outside this list; treat an unrecognised value as a generic failure of its HTTP status. enum: - conflict - contact_not_authorized - document_exceeds_page_limit - downstream_entity_member_exists - duplicate_external_id_error - duplicate_member_email - duplicate_producer_code_error - forbidden - gateway_timeout - inactive_email - internal_server_error - invalid_email - invalid_email_for_invites - invalid_organization_category - invalid_organization_slug - invalid_phone_number - invalid_token - invite_limit_reached - jwt_invalid - m2m_client_not_found - not_found - organization_already_exists - organization_slug_already_used - payment_required - producer_agreement_required - product_feature_subscription_required - service_unavailable - session_authorization_error - some_custom_error_string - throttled - too_many_requests - unauthorized - unauthorized_client - unexpected_400_stytch_error - unexpected_403_stytch_error - unexpected_404_stytch_error - unexpected_error - unexpected_stytch_error - unprocessable_entity - validation_error example: validation_error errorMessage: description: Array of error messages type: array items: type: string timestamp: type: string description: ISO timestamp when the error occurred details: type: object description: Additional error context required: - statusCode - requestId - errorType - errorMessage - timestamp CorporateRegistrationAddressResponse: type: object properties: line1: type: string description: Street address line 1 example: 1200 Market St line2: type: string description: Street address line 2 example: Suite 400 city: type: string description: City example: Philadelphia zip: type: string description: ZIP code example: '19107' state: type: string description: Two-letter state code enum: - AL - AK - AZ - AR - CA - CO - CT - DE - FL - GA - HI - ID - IL - IN - IA - KS - KY - LA - ME - MD - MA - MI - MN - MS - MO - MT - NE - NV - NH - NJ - NM - NY - NC - ND - OH - OK - OR - PA - RI - SC - SD - TN - TX - UT - VT - VA - WA - WV - WI - WY example: PA country: type: string description: Country example: USA required: - country CorporateRegistrationOwnerResponse: type: object properties: ownerType: type: string description: Whether the owner is a person or another entity enum: - entity - individual example: entity fullName: type: string description: Owner name example: Example Holdings LLC ownershipPercent: type: number description: Percentage of the entity owned example: 60 fein: type: string description: Federal Employer Identification Number, for a corporate owner officers: description: >- Officers named on this owner. Names only: dates of birth and residential addresses are never returned. type: array items: $ref: '#/components/schemas/CorporateRegistrationOfficerResponse' required: - ownerType - fullName - officers CorporateRegistrationOfficerResponse: type: object properties: name: type: string description: Officer name example: Robin Cortez required: - name ```` ## Related topics - [List Corporate Registration Filings](/api-reference/v2/downstream/corporate-registrations/list-filings.md) - [Get a Corporate Registration Filing](/api-reference/v2/downstream/corporate-registrations/get-filing.md) - [Open a Corporate Registration Filing](/api-reference/v2/downstream/corporate-registrations/open-filing.md)