# Envato

> Verify buyers' purchase codes and follow your sales, statement and purchases on Envato Market (ThemeForest, CodeCanyon and the rest). Start a workflow on a new sale, statement transaction or purchase, or when an item is updated.

App · 11 actions. Web page: https://docs.lodol.com/docs/integrations/envato

## Actions

### Get account details

Get your Envato username, email address, name, country, balance and the earnings you can withdraw.

**Inputs**: None.

**Outputs**

- `available_earnings` (text): Earnings you can withdraw
- `balance` (text): Your balance: deposits plus earnings
- `country` (text): Your country
- `email` (text): Your email address
- `firstname` (text): Your first name
- `image` (text): Your profile picture
- `surname` (text): Your surname
- `total_deposits` (text): Your deposits
- `username` (text): Your Envato username

**Example output**

```json
{
  "available_earnings": "100.00",
  "balance": "120.00",
  "country": "Australia",
  "email": "jo@example.com",
  "firstname": "Jo",
  "image": "https://0.s3.envato.com/files/avatar.jpg",
  "surname": "Smith",
  "total_deposits": "20.00",
  "username": "jo_smith"
}
```

### Get collection

Get a collection and the items in it: one of yours, or anyone's public collection by its number.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one of yours, or give the number at the end of its web address.

**Outputs**

- `collection` (object): A collection of items
- `count` (number): How many
- `items` (list): The items in it

**Example output**

```json
{
  "collection": {
    "description": "Themes to show clients",
    "id": 12345,
    "image": "https://s3.envato.com/files/collection.png",
    "item_count": 4,
    "name": "Client site themes",
    "private": true,
    "special_role": ""
  },
  "count": 1,
  "items": [
    {
      "author_url": "https://themeforest.net/user/themefusion",
      "author_username": "ThemeFusion",
      "classification": "wordpress/corporate",
      "description": "<p>Avada is the #1 selling WordPress theme.</p>",
      "id": 2833226,
      "name": "Avada | Website Builder For WordPress & WooCommerce",
      "number_of_sales": 1000000,
      "price_cents": 6900,
      "published_at": "2012-08-16T23:35:42+10:00",
      "rating": 4.77,
      "rating_count": 25000,
      "site": "themeforest.net",
      "summary": "Gutenberg Optimized: Yes, High Resolution: Yes",
      "tags": [
        "business",
        "woocommerce"
      ],
      "thumbnail_url": "https://s3.envato.com/files/thumbnail.png",
      "trending": false,
      "updated_at": "2026-10-28T10:12:00+11:00",
      "url": "https://themeforest.net/item/avada-responsive-multipurpose-theme/2833226"
    }
  ]
}
```

### Get download link

Get a link to download an item you bought. Each link counts toward the item's daily download limit.

**Inputs**

- Purchase (`purchase_code`, text): The purchase to download. Pick one, or give its purchase code. Leave empty to give an item instead.
- Item (`item_id`, text): Or the item to download, by its number. Use one or the other, not both.

**Outputs**

- `download_url` (text): The link that downloads the item

**Example output**

```json
{
  "download_url": "https://marketplace-downloads.example/avada.zip"
}
```

### Get item

Get an item on Envato Market: its name, author, price, sales, rating, tags and when it was last updated.

**Inputs**

- Item (`item_id`, text, required): The item. Pick one of yours, or give its number or web address, such as https://themeforest.net/item/avada/2833226.

**Outputs**

- `item` (object): An item on Envato Market

**Example output**

```json
{
  "item": {
    "author_url": "https://themeforest.net/user/themefusion",
    "author_username": "ThemeFusion",
    "classification": "wordpress/corporate",
    "description": "<p>Avada is the #1 selling WordPress theme.</p>",
    "id": 2833226,
    "name": "Avada | Website Builder For WordPress & WooCommerce",
    "number_of_sales": 1000000,
    "price_cents": 6900,
    "published_at": "2012-08-16T23:35:42+10:00",
    "rating": 4.77,
    "rating_count": 25000,
    "site": "themeforest.net",
    "summary": "Gutenberg Optimized: Yes, High Resolution: Yes",
    "tags": [
      "business",
      "woocommerce"
    ],
    "thumbnail_url": "https://s3.envato.com/files/thumbnail.png",
    "trending": false,
    "updated_at": "2026-10-28T10:12:00+11:00",
    "url": "https://themeforest.net/item/avada-responsive-multipurpose-theme/2833226"
  }
}
```

### Get latest WordPress version

Get the latest version number of a WordPress theme or plugin, to check whether an update is out.

**Inputs**

- Item (`item_id`, text, required): The item. Pick one of yours, or give its number or web address, such as https://themeforest.net/item/avada/2833226.

**Outputs**

- `item_id` (number): The item's number
- `latest_version` (text): Its latest version, empty if it isn't for WordPress
- `wordpress_plugin_latest_version` (text): The latest version, if it is a plugin
- `wordpress_theme_latest_version` (text): The latest version, if it is a theme

**Example output**

```json
{
  "item_id": 2833226,
  "latest_version": "7.11.10",
  "wordpress_plugin_latest_version": "",
  "wordpress_theme_latest_version": "7.11.10"
}
```

### Get purchase

Get one of your purchases by its purchase code: the item, license and when its support ends.

**Inputs**

- Purchase (`purchase_code`, text, required): The purchase. Pick one, or give its purchase code.

**Outputs**

- `item` (object): Everything Envato says about the item
- `item_id` (number): The item's number
- `item_name` (text): The item's name
- `item_url` (text): The item's page on Envato Market
- `license` (text): The license bought, such as Regular License
- `purchase_code` (text): The purchase code
- `sold_at` (text): When it was bought (ISO 8601)
- `support_active` (true/false): True while its included support lasts
- `supported_until` (text): When its included support ends (ISO 8601)

**Example output**

```json
{
  "item": {
    "author_url": "https://themeforest.net/user/themefusion",
    "author_username": "ThemeFusion",
    "id": 2833226,
    "name": "Avada | Website Builder For WordPress & WooCommerce",
    "number_of_sales": 1000000,
    "updated_at": "2026-10-28T10:12:00+11:00",
    "url": "https://themeforest.net/item/avada-responsive-multipurpose-theme/2833226"
  },
  "item_id": 2833226,
  "item_name": "Avada | Website Builder For WordPress & WooCommerce",
  "item_url": "https://themeforest.net/item/avada-responsive-multipurpose-theme/2833226",
  "license": "Regular License",
  "purchase_code": "86781236-23d0-4b3c-7dfa-c1c147e0dece",
  "sold_at": "2026-11-17T09:14:02+11:00",
  "support_active": true,
  "supported_until": "2027-05-17T09:14:02+10:00"
}
```

### List collections

List your collections on Envato Market, public and private.

**Inputs**: None.

**Outputs**

- `collections` (list): Your collections
- `count` (number): How many

**Example output**

```json
{
  "collections": [
    {
      "description": "Themes to show clients",
      "id": 12345,
      "image": "https://s3.envato.com/files/collection.png",
      "item_count": 4,
      "name": "Client site themes",
      "private": true,
      "special_role": ""
    }
  ],
  "count": 1
}
```

### List purchases

List what you have bought on Envato Market, with each purchase code, license and when its support ends.

**Inputs**

- Kind (`purchase_type`, text): Everything, or only WordPress themes or plugins. One of: `all` (Everything (default)), `wordpress-themes` (WordPress themes), `wordpress-plugins` (WordPress plugins). Default: `all`.
- Full item details (`full_details`, true/false): Also return every detail of each item bought.
- How many at most (`max_results`, number): Defaults to 50. From 1 to 1000. Default: `50`.

**Outputs**

- `count` (number): How many
- `purchases` (list): Your purchases

**Example output**

```json
{
  "count": 1,
  "purchases": [
    {
      "item": {
        "author_url": "https://themeforest.net/user/themefusion",
        "author_username": "ThemeFusion",
        "id": 2833226,
        "name": "Avada | Website Builder For WordPress & WooCommerce",
        "number_of_sales": 1000000,
        "updated_at": "2026-10-28T10:12:00+11:00",
        "url": "https://themeforest.net/item/avada-responsive-multipurpose-theme/2833226"
      },
      "item_id": 2833226,
      "item_name": "Avada | Website Builder For WordPress & WooCommerce",
      "item_url": "https://themeforest.net/item/avada-responsive-multipurpose-theme/2833226",
      "license": "Regular License",
      "purchase_code": "86781236-23d0-4b3c-7dfa-c1c147e0dece",
      "sold_at": "2026-11-17T09:14:02+11:00",
      "support_active": true,
      "supported_until": "2027-05-17T09:14:02+10:00"
    }
  ]
}
```

### List sales

List your most recent sales: the item, buyer, license, what you earned and when support ends. Refunded sales are left out.

**Inputs**

- How many at most (`max_results`, number): Defaults to 50. From 1 to 1000. Default: `50`.

**Outputs**

- `count` (number): How many
- `sales` (list): Your sales, newest first

**Example output**

```json
{
  "count": 1,
  "sales": [
    {
      "amount": "41.40",
      "buyer": "jo_smith",
      "item": {
        "author_url": "https://themeforest.net/user/themefusion",
        "author_username": "ThemeFusion",
        "classification": "wordpress/corporate",
        "description": "<p>Avada is the #1 selling WordPress theme.</p>",
        "id": 2833226,
        "name": "Avada | Website Builder For WordPress & WooCommerce",
        "number_of_sales": 1000000,
        "price_cents": 6900,
        "published_at": "2012-08-16T23:35:42+10:00",
        "rating": 4.77,
        "rating_count": 25000,
        "site": "themeforest.net",
        "summary": "Gutenberg Optimized: Yes, High Resolution: Yes",
        "tags": [
          "business",
          "woocommerce"
        ],
        "thumbnail_url": "https://s3.envato.com/files/thumbnail.png",
        "trending": false,
        "updated_at": "2026-10-28T10:12:00+11:00",
        "url": "https://themeforest.net/item/avada-responsive-multipurpose-theme/2833226"
      },
      "item_id": 2833226,
      "item_name": "Avada | Website Builder For WordPress & WooCommerce",
      "item_url": "https://themeforest.net/item/avada-responsive-multipurpose-theme/2833226",
      "license": "Regular License",
      "purchase_count": 1,
      "sold_at": "2026-11-17T09:14:02+11:00",
      "support_active": true,
      "support_amount": "0.00",
      "supported_until": "2027-05-17T09:14:02+10:00"
    }
  ]
}
```

### List statement transactions

List the lines on your Envato statement, such as sales, fees, refunds and payouts, with the taxes on each.

**Inputs**

- From (`from_date`, date): Only lines on or after this date.
- To (`to_date`, date): Only lines on or before this date.
- Type (`transaction_type`, text): Only lines of this type, written as your statement shows it, such as Sale. Leave empty for every type.
- How many at most (`max_results`, number): Defaults to 50. From 1 to 1000. Default: `50`.

**Outputs**

- `count` (number): How many
- `transactions` (list): The statement lines

**Example output**

```json
{
  "count": 1,
  "transactions": [
    {
      "amount": 41.4,
      "au_gst": 0.0,
      "au_rwt": 0.0,
      "date": "2026-11-17 09:14:02 +1100",
      "detail": "Avada | Website Builder For WordPress & WooCommerce",
      "document": "IVIP1234567",
      "eu_vat": 0.0,
      "item_id": 2833226,
      "order_id": 987654,
      "other_party_city": "Melbourne",
      "other_party_country": "Australia",
      "other_party_region": "VIC",
      "other_party_zipcode": "3000",
      "price": 69.0,
      "site": "themeforest.net",
      "type": "Sale",
      "unique_id": "1234567890",
      "us_bwt": 0.0,
      "us_rwt": 0.0
    }
  ]
}
```

### Verify purchase code

Check a purchase code a buyer gives you against your sales: whether it is real, which item and license it is for, and whether its support is still active. A code that matches none of your sales comes back with valid set to false.

**Inputs**

- Purchase code (`purchase_code`, text, required): The code the buyer gives you, from their Downloads page.

**Outputs**

- `amount` (text): What you earned, before income taxes
- `buyer` (text): The buyer's Envato username
- `item` (object): Everything Envato says about the item
- `item_id` (number): The item's number
- `item_name` (text): The item's name
- `item_url` (text): The item's page on Envato Market
- `license` (text): The license bought, such as Regular License
- `purchase_code` (text): The code checked
- `purchase_count` (number): How many times this buyer bought the item
- `sold_at` (text): When it was bought (ISO 8601)
- `support_active` (true/false): True while its included support lasts
- `support_amount` (text): What you earned for included support
- `supported_until` (text): When its included support ends (ISO 8601)
- `valid` (true/false): True if the code is a sale of one of your items

**Example output**

```json
{
  "amount": "41.40",
  "buyer": "jo_smith",
  "item": {
    "author_url": "https://themeforest.net/user/themefusion",
    "author_username": "ThemeFusion",
    "classification": "wordpress/corporate",
    "description": "<p>Avada is the #1 selling WordPress theme.</p>",
    "id": 2833226,
    "name": "Avada | Website Builder For WordPress & WooCommerce",
    "number_of_sales": 1000000,
    "price_cents": 6900,
    "published_at": "2012-08-16T23:35:42+10:00",
    "rating": 4.77,
    "rating_count": 25000,
    "site": "themeforest.net",
    "summary": "Gutenberg Optimized: Yes, High Resolution: Yes",
    "tags": [
      "business",
      "woocommerce"
    ],
    "thumbnail_url": "https://s3.envato.com/files/thumbnail.png",
    "trending": false,
    "updated_at": "2026-10-28T10:12:00+11:00",
    "url": "https://themeforest.net/item/avada-responsive-multipurpose-theme/2833226"
  },
  "item_id": 2833226,
  "item_name": "Avada | Website Builder For WordPress & WooCommerce",
  "item_url": "https://themeforest.net/item/avada-responsive-multipurpose-theme/2833226",
  "license": "Regular License",
  "purchase_code": "86781236-23d0-4b3c-7dfa-c1c147e0dece",
  "purchase_count": 1,
  "sold_at": "2026-11-17T09:14:02+11:00",
  "support_active": true,
  "support_amount": "0.00",
  "supported_until": "2027-05-17T09:14:02+10:00",
  "valid": true
}
```
