> For the complete documentation index, see [llms.txt](https://docs.craft.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.craft.co/added-companies-api/basic-query.md).

# Query

The [Added Company API](/added-companies-api/added-companies-api-introduction.md) provides a way to query information about new companies.

### Arguments

| Argument             | Type                                                          | Description                                                                   | Default |
| -------------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------- |
| first                | Int                                                           | Number of companies to retrieve, should not exceed 100                        | 100     |
| offset               | Int                                                           | Offset in the list                                                            | 0       |
| activatedAtTimeFrame | [TimeFrame!](/company-data-api/graphql-objects/time-frame.md) | A specific time period to retrieve added companies, should not exceed 30 days |         |

### Fields

| Filed      | Type                                                                   | Description                                     |
| ---------- | ---------------------------------------------------------------------- | ----------------------------------------------- |
| nodes      | \[[BasicCompany](/added-companies-api/basic-query/basic-company.md)!]! | Basic company fields                            |
| totalCount | Int!                                                                   | Total count of all added companies for a period |

### Query example

```graphql
# query
query addedCompanies($activatedAtTimeFrame: TimeFrame!, $first: Int!, offset: Int!) {
  addedCompanies(activatedAtTimeFrame: $activatedAtTimeFrame, first: $first, offset: $offset) {
    nodes {
      activatedAt
      displayName
      duns
      homepage
      id
      slug
    }
    totalCount
  }
}

# variables
{ "activatedAtTimeFrame": {
    "from": "2020-07-03", 
    "to": "2020-07-07"
  },
  "first": 10,
  "offset": 10
}
```