# Codewars

> Look up Codewars users and kata (coding challenges): a user's rank, honor and languages, the kata they have completed or written, and any kata's difficulty and stats. Start a workflow when someone completes a kata. No account or API key needed.

App · 4 actions. Web page: https://docs.lodol.com/docs/integrations/codewars

## Actions

### Get kata

Look up a kata (a coding challenge): its difficulty (such as '6 kyu'), instructions, tags, languages, author, and how many people have tried and completed it.

**Inputs**

- Kata (`kata`, text, required): The kata's link (e.g. https://www.codewars.com/kata/5277c8a221e209d3f6000b56), its id or its slug (e.g. valid-braces).

**Outputs**

- `approved` (true/false): True once the kata is approved; false while it is in beta.
- `approved_at` (text): When the kata was approved, in UTC. Empty while in beta.
- `approved_by` (text): The username of the person who approved the kata. Empty while in beta.
- `author` (text): The username of the person who wrote the kata.
- `author_url` (text): The author's profile page on codewars.com.
- `category` (text): The kind of kata, e.g. 'Algorithms', 'Reference' or 'Bug fixes'.
- `created_at` (text): When the kata was created, in UTC.
- `description` (text): The kata's instructions, in Markdown.
- `id` (text): The kata's id, e.g. '5277c8a221e209d3f6000b56'.
- `languages` (list): The languages the kata can be solved in.
- `name` (text): The kata's name, e.g. 'Valid Braces'.
- `open_issues` (number): Reported problems with the kata not yet resolved.
- `open_suggestions` (number): Suggestions for the kata not yet resolved.
- `published_at` (text): When the kata was published, in UTC.
- `rank` (text): How hard the kata is, from '8 kyu' (easiest) to '1 kyu' (hardest), or 'Beta' for a kata not yet approved and ranked.
- `rank_color` (text): The colour Codewars shows the rank in: white, yellow, blue or purple. Empty for a beta kata.
- `slug` (text): The kata's name as it appears in links, e.g. 'valid-braces'.
- `tags` (list): The kata's tags, e.g. ['Algorithms', 'Strings'].
- `total_attempts` (number): How many times people have tried the kata.
- `total_completed` (number): How many times people have completed the kata.
- `total_stars` (number): How many people have bookmarked the kata with a star.
- `url` (text): The kata's page on codewars.com.
- `vote_score` (number): The kata's score from people's votes on it.

**Example output**

```json
{
  "approved": true,
  "approved_at": "2013-12-20T14:53:06Z",
  "approved_by": "xDranik",
  "author": "xDranik",
  "author_url": "https://www.codewars.com/users/xDranik",
  "category": "Algorithms",
  "created_at": "2013-11-04T16:17:38Z",
  "description": "Write a function that takes a string of braces, and ...",
  "id": "5277c8a221e209d3f6000b56",
  "languages": [
    "JavaScript",
    "Python",
    "C++",
    "C#"
  ],
  "name": "Valid Braces",
  "open_issues": 7,
  "open_suggestions": 12,
  "published_at": "2013-11-05T00:07:31Z",
  "rank": "6 kyu",
  "rank_color": "yellow",
  "slug": "valid-braces",
  "tags": [
    "Algorithms"
  ],
  "total_attempts": 494335,
  "total_completed": 84441,
  "total_stars": 3525,
  "url": "https://www.codewars.com/kata/5277c8a221e209d3f6000b56",
  "vote_score": 6301
}
```

### Get user

Look up a Codewars user: their overall rank (such as '4 kyu'), score, honor, place on the leaderboard, clan, how many kata they have completed and written, and their rank in each language they train in.

**Inputs**

- User (`user`, text, required): The Codewars user: their username, or their profile link (https://www.codewars.com/users/<username>). Usernames are case-sensitive.

**Outputs**

- `clan` (text): The clan (team, school or company) the user names. Empty when none.
- `honor` (number): The user's honor: points earned by solving and writing kata.
- `id` (text): The user's Codewars id.
- `languages` (list): The user's rank in each language they train in, highest score first.
- `leaderboard_position` (number): The user's place on the Codewars honor leaderboard (1 is first). Empty when they are not on it.
- `name` (text): The name the user gives on their profile. Empty when none.
- `profile_url` (text): The user's profile page on codewars.com.
- `rank` (text): The user's overall rank, from '8 kyu' (newest) up to '1 kyu', then '1 dan' and up for the very best.
- `rank_color` (text): The colour Codewars shows the rank in: white, yellow, blue, purple or black.
- `score` (number): The user's overall score, which sets their rank.
- `skills` (list): The skills the user lists on their profile.
- `total_authored` (number): How many kata the user has written.
- `total_completed` (number): How many kata the user has completed.
- `username` (text): The user's Codewars username, e.g. 'g964'.

**Example output**

```json
{
  "clan": "None",
  "honor": 489350,
  "id": "545207bac8e60b30fc000942",
  "languages": [
    {
      "language": "JavaScript",
      "rank": "1 kyu",
      "score": 16799
    },
    {
      "language": "Python",
      "rank": "1 kyu",
      "score": 13552
    },
    {
      "language": "Ruby",
      "rank": "2 kyu",
      "score": 8963
    }
  ],
  "leaderboard_position": 1,
  "name": "",
  "profile_url": "https://www.codewars.com/users/g964",
  "rank": "1 kyu",
  "rank_color": "purple",
  "score": 30497,
  "skills": [],
  "total_authored": 147,
  "total_completed": 2644,
  "username": "g964"
}
```

### List kata completed by user

List the kata (coding challenges) a Codewars user has completed, most recent first, with the languages they solved each one in and when. Narrow it to one language or to kata completed since a date.

**Inputs**

- User (`user`, text, required): The Codewars user: their username, or their profile link (https://www.codewars.com/users/<username>). Usernames are case-sensitive.
- Completed since (`completed_after`, date and time): Only kata completed after this date and time. Leave empty for any time.
- Language (`language`, text): Only kata completed in this language. Leave empty for every language. One of: `agda`, `bf`, `c`, `csharp` (C#), `cpp` (C++), `cfml`, `clojure`, `cobol`, `coffeescript`, `commonlisp` (Common Lisp), and 48 more.
- Maximum kata (`limit`, number): The most kata to list, from 1 to 1000. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many kata this list holds.
- `kata` (list): The completed kata, most recently completed first.
- `total_completed` (number): How many kata the user has completed in all, whatever the filters.
- `username` (text): The user's Codewars username, e.g. 'g964'.

**Example output**

```json
{
  "count": 2,
  "kata": [
    {
      "completed_at": "2026-10-18T13:49:50Z",
      "id": "56f9aa3aba792a0970001ad9",
      "languages": [
        "Java"
      ],
      "name": "Optimize me! DD + ceil",
      "slug": "optimize-me-dd-plus-ceil",
      "url": "https://www.codewars.com/kata/56f9aa3aba792a0970001ad9"
    },
    {
      "completed_at": "2026-10-17T13:53:33Z",
      "id": "5804d54135763659cc000146",
      "languages": [
        "Java"
      ],
      "name": "Time Conversion",
      "slug": "time-conversion",
      "url": "https://www.codewars.com/kata/5804d54135763659cc000146"
    }
  ],
  "total_completed": 10060,
  "username": "monadius"
}
```

### List kata written by user

List the kata (coding challenges) a Codewars user has written, with each one's difficulty, tags, languages and instructions. Kata still in beta are included, with the rank 'Beta'.

**Inputs**

- User (`user`, text, required): The Codewars user: their username, or their profile link (https://www.codewars.com/users/<username>). Usernames are case-sensitive.

**Outputs**

- `count` (number): How many kata this list holds.
- `kata` (list): The kata the user wrote, beta ones included.
- `username` (text): The user's Codewars username, e.g. 'g964'.

**Example output**

```json
{
  "count": 2,
  "kata": [
    {
      "approved": true,
      "description": "Let an array or a list ...",
      "id": "5e4bb05b698ef0001e3344bc",
      "languages": [
        "Prolog",
        "Python",
        "Java"
      ],
      "name": "Operations on sequences",
      "rank": "5 kyu",
      "tags": [
        "Algorithms",
        "Mathematics"
      ],
      "url": "https://www.codewars.com/kata/5e4bb05b698ef0001e3344bc"
    },
    {
      "approved": false,
      "description": "Let us consider, as an example, strings like ...",
      "id": "5e1f2234c5772a000fe7f7ce",
      "languages": [
        "Shell",
        "Perl"
      ],
      "name": "Transform",
      "rank": "Beta",
      "tags": [
        "Fundamentals"
      ],
      "url": "https://www.codewars.com/kata/5e1f2234c5772a000fe7f7ce"
    }
  ],
  "username": "g964"
}
```
