> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.aventure.vc/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aventure.vc/_mcp/server.

# Get entity operating status

GET https://api.aventure.vc/v1/entities/{entityId}/operating-status

Returns current operatingStatus as EntityMutation. Write auth required.

Reference: https://docs.aventure.vc/api-reference/a-venture-api/entity-maintenance/get-operating-status

## Authentication

- `Authorization` header (bearer token, required) — User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key
- `X-API-Key` header (required) — Admin API key for system-to-system write operations

## Request

### Path parameters

- `entityId` (string, required) — Canonical entity UUID

## Response

### 200

OK

- `allowSuspectedShellStrip` (boolean, optional, nullable) — Allow intentional money-like text without a currency marker; prefer --from-file.
- `defaultCurrency` (string, optional, nullable) — Default operating currency.
- `foundedYear` (integer, optional, nullable) — Year founded.
- `nameAlias` (list of object, optional, nullable) — Alternative or former names used for search and display. When supplied, the list replaces existing aliases.
  - `name` (string, required) — Alternate name text
  - `displayable` (boolean, optional, nullable) — Show this alias in public name displays.
  - `type` (enum, optional, nullable) — Alias type classification
    - Allowed values: `alternativeDba`, `relatedLegal`
- `nameBrand` (string, optional, nullable) — Brand name. For Product or Service records, this must name a distinct offering and must not exactly match the joined provider entity. If an eponymous offering has no distinct product-line brand, use a descriptor/category such as Consumer Sedans or Light Industrial Vehicles instead.
- `nameLegal` (string, optional, nullable) — Legal name.
- `newSlug` (string, optional, nullable) — Preferred detail-update slug rename field. Omit on create; when slug is also sent both fields must normalize to the same value.
- `operatingStatus` (enum, optional, nullable) — Operating status. Required on create; omitted update values preserve existing status. Use Acquired Subsidiary when an acquired entity still operates; use Acquired only when it is terminal, folded, or closed. Closed and terminal Acquired keep attached person joins current; update association endDate separately with a closing-date estimate.
  - Allowed values: `Operating`, `Acquired`, `Acquired Subsidiary`, `Closed`, `Inactive`
- `slug` (string, optional, nullable) — Entity URL slug. Create may omit it when the server can derive one; detail updates may rename through this field or newSlug. Company-class slugs are one shared namespace and must end with the HQ location suffix (brand-city-state-country); a held slug returns 409. Product and Service slugs derive from nameBrand, stay scoped to the provider pair, and may repeat across providers; reusing a slug under the same provider or one held by a non-product entity returns 409.
- `status` (object, optional, nullable) — Visibility and verification flags; omitted update fields preserve existing values.
  - `isFeatured` (boolean, optional, nullable) — Set whether this entity is editorially featured
  - `isHidden` (boolean, optional, nullable) — Set whether this entity is hidden from public list and detail views. Create default is true when omitted.
  - `isVerified` (boolean, optional, nullable) — Set whether this entity has passed editorial verification
  - `showOnSitemap` (boolean, optional, nullable) — Set whether this entity is included in the public sitemap. Create default is false when omitted.
- `typeRecord` (string, optional, nullable) — Concrete entity type such as Company, Investment Firm, Product, or Service. Product and Service records always pair with a current productService provider relationship: creates write the join atomically via productServiceProviderId, the sole provider join cannot be removed or re-pointed, and moving an offering to a different provider means delete and recreate.

## Examples

**Response**

```json
{
  "allowSuspectedShellStrip": true,
  "defaultCurrency": "USD",
  "foundedYear": 2020,
  "nameAlias": [
    {
      "name": "Bun",
      "displayable": true,
      "type": "alternativeDba"
    }
  ],
  "nameBrand": "Spec Test Entity",
  "nameLegal": "Spec Test Entity LLC",
  "newSlug": "spec-test-entity-inc",
  "operatingStatus": "Operating",
  "slug": "spec-test-entity-llc",
  "status": {
    "isFeatured": true,
    "isHidden": true,
    "isVerified": true,
    "showOnSitemap": true
  },
  "typeRecord": "Company"
}
```

**SDK Code**

```python
import requests

url = "https://api.aventure.vc/v1/entities/entityId/operating-status"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.aventure.vc/v1/entities/entityId/operating-status';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aventure.vc/v1/entities/entityId/operating-status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.aventure.vc/v1/entities/entityId/operating-status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.aventure.vc/v1/entities/entityId/operating-status")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.aventure.vc/v1/entities/entityId/operating-status', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.aventure.vc/v1/entities/entityId/operating-status");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.aventure.vc/v1/entities/entityId/operating-status")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```