# List basis

URL: https://docs.hanzo.ai/docs/openapi/author/get-author-basis

> Returns the AUDIT TRAIL behind the caller's own royalty: every ledger row with the spend it was computed from, the share applied at the time, the platform's matching half, whether each row satisfies the formula, and the attribution edges that already existed when the row was written.

`GET /v1/author/basis`

> [Author →](https://docs.hanzo.ai/docs/openapi/author) · [All API references →](https://docs.hanzo.ai/docs/openapi) · [Get started →](https://docs.hanzo.ai/docs/guides)

|               |                                        |
| ------------- | -------------------------------------- |
| **Address**   | `https://api.hanzo.ai/v1/author/basis` |
| **Method**    | `GET`                                  |
| **Operation** | `get_author_basis`                     |
| **Auth**      | `Authorization: Bearer $HANZO_API_KEY` |

Returns the AUDIT TRAIL behind the caller's own royalty: every
ledger row with the spend it was computed from, the share applied at the time, the
platform's matching half, whether each row satisfies the formula, and the
attribution edges that already existed when the row was written.

It answers ONE OF TWO SHAPES. An org that has never connected gets
{"isAuthor": false, "defaultShareBps"} — never a 404, which would answer "is this
org an author?" for anyone who asked. An enrolled org gets the basis: isAuthor, id,
status, asOf, shareBps, platformShareBps, defaultShareBps, shareSource, settlesTo,
method (the formula, the rate card and the sizing), ledger, reconciliation, window,
and period when one was requested.

This read NEVER sweeps, and that is the point of it being a separate address from
the dashboard: an audit must not move the money it is auditing, so calling it N
times leaves the balances and the ledger byte-identical.

## Request

1 field.

| Field    | In    | Type   | Required | Description                               |
| -------- | ----- | ------ | -------- | ----------------------------------------- |
| `period` | query | string | —        | Period is the UTC accrual month, YYYY-MM. |

## Response

| Status    | Body            | Meaning |
| --------- | --------------- | ------- |
| `200`     | object          | ok      |
| `default` | problem-details | refused |

`200` body — 1 field.

| Field | In   | Type | Always | Description |
| ----- | ---- | ---- | ------ | ----------- |
| `*`   | body | any  | —      |             |

Failure carries the platform error shape — see [Errors](https://docs.hanzo.ai/docs/errors).

## Examples

**CLI**

```bash
hanzo author basis
```

**SDK**

**.ts**

```ts
import { Configuration, AuthorApi } from 'hanzoai';

const api = new AuthorApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getAuthorBasis();
```

**.py**

```python
from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import AuthorApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = AuthorApi(client).get_author_basis()
```

**.go**

```go
cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.AuthorAPI.GetAuthorBasis(context.Background()).Execute()
if err != nil {
	return err
}
```

**.rs**

```rust
use hanzo_client::apis::{configuration::Configuration, author_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = author_api::get_author_basis(&cfg, Default::default()).await?;
```

**.java**

```java
import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.AuthorApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new AuthorApi(client).getAuthorBasis();
```

**HTTP**

```bash
curl https://api.hanzo.ai/v1/author/basis \
  -H "Authorization: Bearer $HANZO_API_KEY"
```

**MCP**

Tool `author`, op `get_author_basis` — POST the JSON-RPC envelope to `https://api.hanzo.ai/v1/mcp`.

```bash
curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "author",
         "arguments": {
           "op": "get_author_basis",
           "input": {}
         }
       }
     }'
```

---

[Author API](https://docs.hanzo.ai/docs/openapi/author) · [All Hanzo APIs](https://docs.hanzo.ai/docs/openapi) · [Interactive reference](https://docs.hanzo.ai/docs/openapi/reference)