> For the complete documentation index, see [llms.txt](https://archivedocs.stackstate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://archivedocs.stackstate.com/5.1/develop/reference/scripting/script-apis/component.md).

# Component - script API

## Function: `Component.withId(id: Long)`

Get access to a component by its ID.

### Args

* `id` - ID of the component we are querying for. Each component has a unique randomly assigned ID number.

**Builder methods**

Each of the methods below give you an Async result with a set of properties

* `at(time: Instant or Timeslice)` - specifes a [time](/5.1/develop/reference/scripting/script-apis/time.md) for which the query should be executed.
* `get` - gets components details in full, with the following fields:

  ```
  id
  name
  description
  lastUpdateTimestamp
  type
  layer
  domain
  environments
  state
  runState
  outgoingRelations
  incomingRelations
  synchronized
  failingChecks
  iconbase64
  visible
  ```
* `checks` - Gets a list of component checks each with the following fields:

  ```
  id
  lastUpdateTimestamp`
  name
  description
  remediationHint
  function
  arguments
  state
  syncCreated
  ```
* `domain` - Gets the domain the component belongs to with the following fields:

  ```
  id
  lastUpdateTimestamp
  name
  description
  order
  identifier
  ```
* `streams` - Gets a list of component streams each with the following fields:

  ```
  id
  lastUpdateTimestamp
  name
  description
  priority
  dataType
  dataSource
  query
  ```
* `type` - Gets the component type of the given component with the following fields:

  ```
  id
  lastUpdateTimestamp
  name
  description
  iconbase64
  identifier
  ```
* `layer` - Gets the layer for the component with the following fields:

  ```
  id
  lastUpdateTimestamp
  name
  description
  order
  identifier
  ```
* `environments` - Gets a list of environments this component belongs to with following fields:

  ```
  id
  lastUpdateTimestamp
  name
  description
  identifier
  ownedBy
  ```
* `propagation` - Get the propagation for the component if any with the following fields:

  ```
  id
  lastUpdateTimestamp
  function
  arguments
  ```

### Examples

This example returns the name of the layer for the component with ID `123`. After getting the layer the [AsyncScriptResult](/5.1/develop/reference/scripting/async-script-result.md) `then` function is used to get the name of the layer.

```
Component.withId(123).layer().then { it.name }
```