---
title: "Get incorporation project details"
method: GET
path: "/incorporate/details/{tokenAddress}"
tags: ["Incorporation"]
---

# Get incorporation project details

`GET /incorporate/details/{tokenAddress}`

## Request

- Base URL: `https://public-api-v2.bags.fm/api/v1`
- URL: `https://public-api-v2.bags.fm/api/v1/incorporate/details/{tokenAddress}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/bags/apis/bags-public-api-v2/docs/incorporate/details/:tokenAddress/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves details for a specific incorporation project by token address.

## Path parameters

- `tokenAddress` string, required

## Response `200`

Successfully retrieved incorporation project details

- object
  - `success` boolean, required
  - `response` object
    - `tokenAddress` string, required: Token mint address
    - `incorporationStatus` string, required: Current incorporation status
    - `incorporationShareBasisPoint` number, required: Incorporation share in basis points
    - `category` string, nullable: Project category
    - `twitterHandle` string, nullable: Twitter handle
    - `createdAt` string, required: ISO timestamp of project creation
    - `preferredCompanyNames` string[], required: Preferred company names
    - `isReadyForIncorporation` boolean, required: Whether all prerequisites are met for incorporation

## Other responses

- `400`: Bad request - Invalid token address
- `401`: Unauthorized - Invalid or missing API key
- `404`: Not found - No incorporation project found for the given token address
- `500`: Internal server error

---

[API](https://skmtc.dev/bags/apis/bags-public-api-v2.md) - [All operations](https://skmtc.dev/bags/apis/bags-public-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/bags/apis/bags-public-api-v2/revisions/4a14b82cd39d?raw)