# Run<!-- -->

Represents an Actor run and its associated data.

## Index[**](#Index)

### Properties

* [**act\_id](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#act_id)
* [**actor\_task\_id](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#actor_task_id)
* [**build\_id](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#build_id)
* [**build\_number](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#build_number)
* [**charged\_event\_counts](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#charged_event_counts)
* [**container\_url](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#container_url)
* [**default\_dataset\_id](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#default_dataset_id)
* [**default\_key\_value\_store\_id](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#default_key_value_store_id)
* [**default\_request\_queue\_id](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#default_request_queue_id)
* [**exit\_code](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#exit_code)
* [**finished\_at](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#finished_at)
* [**general\_access](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#general_access)
* [**git\_branch\_name](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#git_branch_name)
* [**id](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#id)
* [**is\_container\_server\_ready](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#is_container_server_ready)
* [**is\_status\_message\_terminal](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#is_status_message_terminal)
* [**meta](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#meta)
* [**metamorphs](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#metamorphs)
* [**model\_config](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#model_config)
* [**options](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#options)
* [**platform\_usage\_billing\_model](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#platform_usage_billing_model)
* [**pricing\_info](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#pricing_info)
* [**started\_at](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#started_at)
* [**stats](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#stats)
* [**status](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#status)
* [**status\_message](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#status_message)
* [**storage\_ids](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#storage_ids)
* [**usage](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#usage)
* [**usage\_total\_usd](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#usage_total_usd)
* [**usage\_usd](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#usage_usd)
* [**user\_id](https://docs.apify.com/api/client/python/api/client/python/reference/class/Run.md#user_id)

## Properties<!-- -->[**](#Properties)

### [**](#act_id)act\_id

**act\_id: str

ID of the Actor that was run.

### [**](#actor_task_id)actor\_task\_id

**actor\_task\_id: str | None

ID of the Actor task, if the run was started from a task.

### [**](#build_id)build\_id

**build\_id: str

ID of the Actor build used for this run.

### [**](#build_number)build\_number

**build\_number: str | None

Build number of the Actor build used for this run.

### [**](#charged_event_counts)charged\_event\_counts

**charged\_event\_counts: dict\[str, int] | None

A map of charged event types to their counts. The keys are event type identifiers defined by the Actor's pricing model (pay-per-event), and the values are the number of times each event was charged during this run.

### [**](#container_url)container\_url

**container\_url: AnyUrl | None

URL of the container running the Actor.

### [**](#default_dataset_id)default\_dataset\_id

**default\_dataset\_id: str

ID of the default dataset for this run.

### [**](#default_key_value_store_id)default\_key\_value\_store\_id

**default\_key\_value\_store\_id: str

ID of the default key-value store for this run.

### [**](#default_request_queue_id)default\_request\_queue\_id

**default\_request\_queue\_id: str

ID of the default request queue for this run.

### [**](#exit_code)exit\_code

**exit\_code: int | None

Exit code of the Actor run process.

### [**](#finished_at)finished\_at

**finished\_at: AwareDatetime | None

Time when the Actor run finished.

### [**](#general_access)general\_access

**general\_access: [GeneralAccess](https://docs.apify.com/api/client/python/api/client/python/reference.md#GeneralAccess)

General access level for the Actor run.

### [**](#git_branch_name)git\_branch\_name

**git\_branch\_name: str | None

Name of the git branch used for the Actor build.

### [**](#id)id

**id: str

Unique identifier of the Actor run.

### [**](#is_container_server_ready)is\_container\_server\_ready

**is\_container\_server\_ready: bool | None

Whether the container's HTTP server is ready to accept requests.

### [**](#is_status_message_terminal)is\_status\_message\_terminal

**is\_status\_message\_terminal: bool | None

Whether the status message is terminal (final).

### [**](#meta)meta

**meta: [RunMeta](https://docs.apify.com/api/client/python/api/client/python/reference/class/RunMeta.md)

Metadata about the Actor run.

### [**](#metamorphs)metamorphs

**metamorphs: [list](https://docs.apify.com/api/client/python/api/client/python/reference/class/ActorCollectionClient.md#list)\[[Metamorph](https://docs.apify.com/api/client/python/api/client/python/reference/class/Metamorph.md)] | None

List of metamorph events that occurred during the run.

### [**](#model_config)model\_config

**model\_config: Undefined

### [**](#options)options

**options: [RunOptions](https://docs.apify.com/api/client/python/api/client/python/reference/class/RunOptions.md)

Configuration options for the Actor run.

### [**](#platform_usage_billing_model)platform\_usage\_billing\_model

**platform\_usage\_billing\_model: str | None

Indicates which party covers platform usage costs for this run.

### [**](#pricing_info)pricing\_info

**pricing\_info: ((([PayPerEventActorPricingInfo](https://docs.apify.com/api/client/python/api/client/python/reference/class/PayPerEventActorPricingInfo.md) | [PricePerDatasetItemActorPricingInfo](https://docs.apify.com/api/client/python/api/client/python/reference/class/PricePerDatasetItemActorPricingInfo.md)) | [FlatPricePerMonthActorPricingInfo](https://docs.apify.com/api/client/python/api/client/python/reference/class/FlatPricePerMonthActorPricingInfo.md)) | [FreeActorPricingInfo](https://docs.apify.com/api/client/python/api/client/python/reference/class/FreeActorPricingInfo.md)) | None

Pricing information for the Actor.

### [**](#started_at)started\_at

**started\_at: AwareDatetime

Time when the Actor run started.

### [**](#stats)stats

**stats: [RunStats](https://docs.apify.com/api/client/python/api/client/python/reference/class/RunStats.md)

Statistics of the Actor run.

### [**](#status)status

**status: [ActorJobStatus](https://docs.apify.com/api/client/python/api/client/python/reference.md#ActorJobStatus)

Current status of the Actor run.

### [**](#status_message)status\_message

**status\_message: str | None

Detailed message about the run status.

### [**](#storage_ids)storage\_ids

**storage\_ids: [StorageIds](https://docs.apify.com/api/client/python/api/client/python/reference/class/StorageIds.md) | None

A map of aliased storage IDs associated with this run, grouped by storage type.

### [**](#usage)usage

**usage: [RunUsage](https://docs.apify.com/api/client/python/api/client/python/reference/class/RunUsage.md) | None

Resource usage statistics for the run.

### [**](#usage_total_usd)usage\_total\_usd

**usage\_total\_usd: float | None

Total cost in USD for this run. Represents what you actually pay. For run owners: includes platform usage (compute units) and/or event costs depending on the Actor's pricing model. For run non-owners: only available for Pay-Per-Event Actors (event costs only). Requires authentication token to access.

### [**](#usage_usd)usage\_usd

**usage\_usd: [RunUsageUsd](https://docs.apify.com/api/client/python/api/client/python/reference/class/RunUsageUsd.md) | None

Platform usage costs breakdown in USD. Only present if you own the run AND are paying for platform usage (Pay-Per-Usage, Rental, or Pay-Per-Event with usage costs like standby Actors). Not available for standard Pay-Per-Event Actors. Requires authentication token to access.

### [**](#user_id)user\_id

**user\_id: str

ID of the user who started the run.