# Get the current state of a machine instance.

**GET /machines/{machineSlug}/i/{instanceSlug}**

Retrieve the state of the machine instance that was previously created by
calling `POST /machines/{machineSlug}` and may have had events sent to it
by calling `POST /machines/{machineSlug}/i/{instanceSlug}/events`.

The `allowRead` function for the machine definition version will be called
to authorize the read and, if it fails, a 403 with code
`rejected-by-machine-authorizer` will be returned.

Otherwise, the current state of the machine instance will be returned.

Obviously, the state returned may be out of date by the time it is returned
because reads are non-blocking but a the returned state will always be
self-consistent.



## Servers
- Production server: https://api.statebacked.dev (Production server)


## Authentication methods
- Bearer auth


## Parameters

#### Path parameters
- **machineSlug** (string)
  The slug/name for the machine definition.
- **instanceSlug** (string)
  The slug/name for the machine instance.



## Responses
### 200: The state was retrieved successfully.

#### Body Parameters:  (object)
- **ts** (number)
  Timestamp for when the state was created
- **state** (string | object)
  
- **publicContext** (object)
  The public context of the machine instance.

This includes all context under the `public` key.

- **tags** (array[string])
  Array of tags for the current states
- **done** (boolean)
  Is the state machine complete

### 403: The request was unauthorized.

#### Body Parameters:  (object)
- **error** (string)
  A description of the error.
- **code** (string)
  A code specifying the type of error.


[Powered by Bump.sh](https://bump.sh)