> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercurjs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upsert Professional Details

> Create or update a seller's legal and tax details.

Creates the seller's professional details if none exist, otherwise updates them.

## Path parameters

**id** `string` *required*

The seller's ID.

## Query parameters

**fields** `string`

Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.

## Body parameters

**corporate\_name** `string`

Registered corporate name.

**registration\_number** `string`

Company registration number.

**tax\_id** `string`

Tax identification number.

**additional\_data** `object`

Extra data passed to workflow hooks.

## Response

**seller** `object`

**properties**

**id** `string`

The seller's ID.

**professional\_details** `object`

**properties**

**corporate\_name** `string`

Registered corporate name.

**registration\_number** `string`

Company registration number.

**tax\_id** `string`

Tax identification number.

**updated\_at** `string`

Last update timestamp.

```bash cURL theme={null}
curl -X POST 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/professional-details' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "corporate_name": "Acme GmbH",
    "registration_number": "HRB 123456",
    "tax_id": "DE123456789"
  }'
```

```ts JS Client theme={null}
const { seller } = await client.admin.sellers.$id.professionalDetails.mutate({
  $id: "sel_01HXYZABCDEF",
  corporate_name: "Acme GmbH",
  registration_number: "HRB 123456",
  tax_id: "DE123456789",
})
```

```json 200 theme={null}
{
  "seller": {
    "id": "sel_01HXYZABCDEF",
    "name": "Acme",
    "status": "open",
    "professional_details": {
      "corporate_name": "Acme GmbH",
      "registration_number": "HRB 123456",
      "tax_id": "DE123456789"
    },
    "updated_at": "2026-06-12T11:30:00.000Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.