Verball

API for verbs from different languages with translations and conjugations.

Languages ¶

Resources for the Languages of the Verbs.

Language Collection ¶

List All Languages
GET`/languages`

Example URI

GET /languages

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

[
  {
    "code": "en",
    "id": "en",
    "name": "english",
    "nativeName": "english",
    "url": "/languages/en",
    "pronouns": {
      "s1": "I",
      "p1": "we",
      "s2": "you",
      "p2": "you",
      "s3m": "he",
      "s3f": "she",
      "s3n": "it",
      "p3": "they"
    },
    "tenses": [
      {
        "name": "simple past",
        "nativeName": "simple past",
        "_id": "simplePast"
      },
      {
        "name": "present",
        "nativeName": "present",
        "_id": "present"
      }
    ]
  },
  {
    "code": "de",
    "id": "de",
    "name": "german",
    "nativeName": "deutsch",
    "url": "/languages/de",
    "pronouns": {
      "s1": "ich",
      "p1": "wir",
      "s2": "du",
      "p2": "ihr",
      "s3m": "er",
      "s3f": "sie",
      "s3n": "es",
      "p3": "sie",
      "form": "Sie"
    },
    "tenses": [
      {
        "name": "simple past",
        "nativeName": "Präteritum",
        "_id": "simplePast"
      },
      {
        "name": "present",
        "nativeName": "Präsens",
        "_id": "present"
      }
    ]
  }
]

Create a Language
POST`/languages`

To create a new Language you have POST a JSON document including the ISO 639-1 code, the English name and the native name of the language.

code (string) - ISO 639-1 code of the language
name (string) - English name of the language
nativeName (string) - Native name of the language
pronouns (object) - Pronouns of the language
tenses (array) - Array of tenses
- name (string) - Name of the tense
- nativeName (string) - Native name of the tense

Example URI

POST /languages

Request

HideShow

Headers

Content-Type: application/json

Body

{
  "code": "fr",
  "name": "French",
  "nativeName": "Français",
  "pronouns": {
    "s1": "je",
    "p1": "nous",
    "s2": "tu",
    "p2": "vous",
    "s3m": "il",
    "s3f": "elle",
    "p3m": "ils",
    "p3f": "elles",
    "form": "vous"
  },
  "tenses": [
    {
      "name": "simple past",
      "nativeName": "passé simple"
    },
    {
      "name": "present",
      "nativeName": "présent"
    }
  ]
}

Response 201

HideShow

Headers

Content-Type: application/json; charset=utf-8
Location: /language/fr

Body

{
  "code": "fr",
  "id": "fr",
  "name": "french",
  "nativeName": "français",
  "url": "/languages/fr",
  "pronouns": {
    "s1": "je",
    "p1": "nous",
    "s2": "tu",
    "p2": "vous",
    "s3m": "il",
    "s3f": "elle",
    "p3m": "ils",
    "p3f": "elles",
    "form": "vous"
  },
  "tenses": [
    {
      "name": "simple past",
      "nativeName": "passé simple",
      "_id": "simplePast"
    },
    {
      "name": "present",
      "nativeName": "présent",
      "_id": "present"
    }
  ]
}

Language ¶

Get a Language
GET`/languages/{language_code}`

Example URI

GET /languages/en

URI Parameters

HideShow

language_code: string (required) Example: en
ISO 639-1 Code of the Language

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

{
  "code": "en",
  "id": "en",
  "name": "english",
  "nativeName": "english",
  "url": "/languages/en",
  "pronouns": {
    "s1": "I",
    "p1": "we",
    "s2": "you",
    "p2": "you",
    "s3m": "he",
    "s3f": "she",
    "s3n": "it",
    "p3": "they"
  },
  "tenses": [
    {
      "name": "simple past",
      "nativeName": "Präteritum",
      "_id": "simplePast"
    },
    {
      "name": "present",
      "nativeName": "Präsens",
      "_id": "present"
    }
  ]
}

Update a Language
PUT`/languages/{language_code}`

name (string) - English Name of the Language
nativeName (string) - Native Name of the Language

Example URI

PUT /languages/en

URI Parameters

HideShow

language_code: string (required) Example: en
ISO 639-1 Code of the Language

Request

HideShow

Headers

Content-Type: application/json

Body

{
  "nativeName": "american",
  "pronouns": {
    "p2": "y'all"
  }
}

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8
Location: /languages/en

Body

{
  "code": "en",
  "id": "en",
  "name": "english",
  "nativeName": "american",
  "url": "/languages/en",
  "pronouns": {
    "s1": "I",
    "p1": "we",
    "s2": "you",
    "p2": "y'all",
    "s3m": "he",
    "s3f": "she",
    "s3n": "it",
    "p3": "they"
  },
  "tenses": [
    {
      "name": "simple past",
      "nativeName": "Präteritum",
      "_id": "simplePast"
    },
    {
      "name": "present",
      "nativeName": "Präsens",
      "_id": "present"
    }
  ]
}

Delete a Language
DELETE`/languages/{language_code}`

Example URI

DELETE /languages/en

URI Parameters

HideShow

language_code: string (required) Example: en
ISO 639-1 Code of the Language

Response 204

Verbs ¶

Resources for Verbs.

Verb Collection ¶

List All Verbs
GET`/verbs`

Example URI

GET /verbs

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

[
  {
    "infinitive": "go",
    "language": "en",
    "url": "/verbs/en/go",
    "id": "5849da8acb46ec150a090068",
    "conjugations": {
      "present": {
        "s1": "go",
        "s2": "go",
        "s3m": "goes"
      }
    }
  },
  {
    "infinitive": "gehen",
    "language": "de",
    "url": "/verbs/de/gehen",
    "id": "5849dfbbfa380e1a36daf91d",
    "conjugations": {
      "present": {
        "s1": "gehe",
        "s2": "gehst",
        "s3m": "geht"
      }
    }
  },
  {
    "infinitive": "fahren",
    "language": "de",
    "url": "/verbs/de/fahren",
    "id": "5849eb774a5d2f244f416e6a",
    "conjugations": {
      "present": {
        "s1": "fahre",
        "s2": "fährst",
        "s3m": "fährt"
      }
    }
  }
]

List All Verbs of a Language
GET`/verbs/{language_code}`

Example URI

GET /verbs/en

URI Parameters

HideShow

language_code: string (optional) Example: en
ISO 639-1 Code of the Language

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

[
  {
    "infinitive": "go",
    "language": "en",
    "url": "/verbs/en/go",
    "id": "5849da8acb46ec150a090068",
    "conjugations": {
      "present": {
        "s1": "go",
        "s2": "go",
        "s3m": "goes"
      }
    }
  }
]

Find All Verbs Matching a Query String
GET`/verbs?q={query}`

Example URI

GET /verbs?q=go

URI Parameters

HideShow

query: string (optional) Example: go
Query string for verb infinitive.

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

[
  {
    "infinitive": "go",
    "language": "en",
    "url": "/verbs/en/go",
    "id": "5849da8acb46ec150a090068",
    "conjugations": {
      "present": {
        "s1": "go",
        "s2": "go",
        "s3m": "goes"
      }
    }
  }
]

Create a Verb
POST`/verbs`

infinitive (string) - Infinitive of the Verb
language (string) - ISO 639-1 Code of the Language

Example URI

POST /verbs

Request

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

{
  "infinitive": "fly",
  "language": "en",
  "conjugations": {
    "present": {
      "s1": "fly",
      "s2": "fly",
      "s3m": "flies"
    }
  }
}

Response 201

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

{
  "infinitive": "fly",
  "language": "en",
  "url": "/verbs/en/fly",
  "id": "5849da8acb46ec150a090068",
  "conjugations": {
    "present": {
      "s1": "fly",
      "s2": "fly",
      "s3m": "flies"
    }
  }
}

Verb ¶

Get a Verb By ID
GET`/verbs/{id}`

Example URI

GET /verbs/5849da8acb46ec150a090068

URI Parameters

HideShow

id: string (optional) Example: 5849da8acb46ec150a090068
ID of the Verb

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

{
  "infinitive": "go",
  "language": "en",
  "url": "/verbs/en/go",
  "id": "5849da8acb46ec150a090068",
  "conjugations": {
    "present": {
      "s1": "go",
      "s2": "go",
      "s3m": "goes"
    }
  }
}

Get a Verb By Language and Infinitive
GET`/verbs/{language_code}/{infinitive}`

Example URI

GET /verbs/en/go

URI Parameters

HideShow

language_code: string (required) Example: en
ISO 639-1 code of the Language
infinitive: string (required) Example: go
Infinitive of the Verb

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

{
  "infinitive": "go",
  "language": "en",
  "url": "/verbs/en/go",
  "id": "5849da8acb46ec150a090068",
  "conjugations": {
    "present": {
      "s1": "go",
      "s2": "go",
      "s3m": "goes"
    }
  }
}

Get Translations of a Verb by Language and Infinitive
GET`/verbs/{language_code}/{infinitive}/translations`

Example URI

GET /verbs/en/go/translations

URI Parameters

HideShow

language_code: string (required) Example: en
ISO 639-1 code of the Language
infinitive: string (required) Example: go
Infinitive of the Verb

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

[
  {
    "infinitive": "gehen",
    "language": "de",
    "url": "/verbs/de/gehen",
    "id": "5849dfbbfa380e1a36daf91d",
    "conjugations": {
      "present": {
        "s1": "gehe",
        "s2": "gehst",
        "s3m": "geht"
      }
    }
  }
]

Get Translations of a Verb by ID
GET`/verbs/{id}/translations`

Example URI

GET /verbs/5849da8acb46ec150a090068/translations

URI Parameters

HideShow

id: string (required) Example: 5849da8acb46ec150a090068
ID of the Verb

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

[
  {
    "infinitive": "gehen",
    "language": "de",
    "url": "/verbs/de/gehen",
    "id": "5849dfbbfa380e1a36daf91d",
    "conjugations": {
      "present": {
        "s1": "gehe",
        "s2": "gehst",
        "s3m": "geht"
      }
    }
  }
]

Create a Translation of a Verb
POST`/verbs/{language_code}/{infinitive}/translations`

Example URI

POST /verbs/en/go/translations

URI Parameters

HideShow

language_code: string (required) Example: en
ISO 639-1 code of the Language
infinitive: string (required) Example: go
Infinitive of the Verb

Request

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

{
  "infinitive": "hingehen",
  "language": "de",
  "conjugations": {
    "present": {
      "s1": "gehe hin",
      "s2": "gehst hin",
      "s3m": "geht hin"
    }
  }
}

Response 201

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

[
  {
    "infinitive": "go",
    "language": "en",
    "url": "/verbs/en/go",
    "id": "5849da8acb46ec150a090068",
    "conjugations": {
      "present": {
        "s1": "go",
        "s2": "go",
        "s3m": "goes"
      }
    }
  },
  {
    "infinitive": "hingehen",
    "language": "de",
    "url": "/verbs/de/hingehen",
    "id": "584b0ed824a4b9032d2cde1f",
    "conjugations": {
      "present": {
        "s1": "gehe hin",
        "s2": "gehst hin",
        "s3m": "geht hin"
      }
    }
  }
]

Link Translations of two Verbs
POST`/verbs/{language_code}/{infinitive}/translations/{translation_language_code}`

Example URI

POST /verbs/en/go/translations/de

URI Parameters

HideShow

language_code: string (required) Example: en
ISO 639-1 code of the Language
infinitive: string (required) Example: go
Infinitive of the Verb
translation_language_code: string (required) Example: de
ISO 639-1 code of the Translation Language

Request with ID

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

{
  "id": "5849eb774a5d2f244f416e6a"
}

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

[
  {
    "infinitive": "go",
    "language": "en",
    "url": "/verbs/en/go",
    "id": "5849da8acb46ec150a090068",
    "conjugations": {
      "present": {
        "s1": "go",
        "s2": "go",
        "s3m": "goes"
      }
    }
  },
  {
    "infinitive": "fahren",
    "language": "de",
    "url": "/verbs/de/fahren",
    "id": "5849eb774a5d2f244f416e6a",
    "conjugations": {
      "present": {
        "s1": "fahre",
        "s2": "fährst",
        "s3m": "fährt"
      }
    }
  }
]

Request with Infinitive

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

{
  "infinitive": "fahren"
}

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

[
  {
    "infinitive": "go",
    "language": "en",
    "url": "/verbs/en/go",
    "id": "5849da8acb46ec150a090068",
    "conjugations": {
      "present": {
        "s1": "go",
        "s2": "go",
        "s3m": "goes"
      }
    }
  },
  {
    "infinitive": "fahren",
    "language": "de",
    "url": "/verbs/de/fahren",
    "id": "5849eb774a5d2f244f416e6a",
    "conjugations": {
      "present": {
        "s1": "fahre",
        "s2": "fährst",
        "s3m": "fährt"
      }
    }
  }
]

Update Verb by ID
PUT`/verbs/{id}`

Example URI

PUT /verbs/5849da8acb46ec150a090068

URI Parameters

HideShow

id: string (required) Example: 5849da8acb46ec150a090068
ID of the Verb

Request

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

{
  "infinitive": "Walk",
  "conjugations": {
    "present": {
      "1s": "walk",
      "2s": "walk",
      "3ms": "walks"
    }
  }
}

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

{
  "infinitive": "walk",
  "language": "de",
  "url": "/verbs/de/walk",
  "id": "5849dfbbfa380e1a36daf91d",
  "conjugations": {
    "present": {
      "s1": "walk",
      "s2": "walk",
      "s3m": "walks"
    }
  }
}

Update Verb by Language Code and Infinitive
PUT`/verbs/{language_code}/{infinitive}`

Example URI

PUT /verbs/en/go

URI Parameters

HideShow

language_code: string (required) Example: en
ISO 639-1 code of the Language
infinitive: string (required) Example: go
Infinitive of the Verb

Request

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

{
  "infinitive": "Walk",
  "conjugations": {
    "present": {
      "s1": "walk",
      "s2": "walk",
      "s3m": "walk"
    }
  }
}

Response 200

HideShow

Headers

Content-Type: application/json; charset=utf-8

Body

{
  "infinitive": "walk",
  "language": "en",
  "url": "/verbs/en/walk",
  "id": "5849dfbbfa380e1a36daf91d",
  "conjugations": {
    "present": {
      "s1": "walk",
      "s2": "walk",
      "s3m": "walks"
    }
  }
}

Delete Verb by ID
DELETE`/verbs/{id}`

Example URI

DELETE /verbs/5849da8acb46ec150a090068

URI Parameters

HideShow

id: string (required) Example: 5849da8acb46ec150a090068
ID of the Verb

Response 204

Delete Verb by Language Code and Infinitive
DELETE`/verbs/{language_code}/{infinitive}`

Example URI

DELETE /verbs/en/go

URI Parameters

HideShow

language_code: string (required) Example: en
ISO 639-1 code of the Language
infinitive: string (required) Example: go
Infinitive of the Verb

Response 204

Languages ¶

Language Collection ¶

List All LanguagesGET/languages

Example URI

Headers

Body

Create a LanguagePOST/languages

Example URI

Headers

Body

Headers

Body

Language ¶

Get a LanguageGET/languages/{language_code}

Example URI

Headers

Body

Update a LanguagePUT/languages/{language_code}

Example URI

Headers

Body

Headers

Body

Delete a LanguageDELETE/languages/{language_code}

Example URI

Verbs ¶

Verb Collection ¶

List All VerbsGET/verbs

Example URI

Headers

Body

List All Verbs of a LanguageGET/verbs/{language_code}

Example URI

Headers

Body

Find All Verbs Matching a Query StringGET/verbs?q={query}

Example URI

Headers

Body

Create a VerbPOST/verbs

Example URI

Headers

Body

Headers

Body

Verb ¶

Get a Verb By IDGET/verbs/{id}

Example URI

Headers

Body

Get a Verb By Language and InfinitiveGET/verbs/{language_code}/{infinitive}

Example URI

Headers

Body

Get Translations of a Verb by Language and InfinitiveGET/verbs/{language_code}/{infinitive}/translations

Example URI

Headers

Body

Get Translations of a Verb by IDGET/verbs/{id}/translations

Example URI

Headers

Body

Create a Translation of a VerbPOST/verbs/{language_code}/{infinitive}/translations

Example URI

Headers

Body

Headers

Body

Link Translations of two VerbsPOST/verbs/{language_code}/{infinitive}/translations/{translation_language_code}

Example URI

Headers

Body

Headers

Body

Headers

Body

Headers

Body

Update Verb by IDPUT/verbs/{id}

Example URI

List All Languages
GET`/languages`

Create a Language
POST`/languages`

Get a Language
GET`/languages/{language_code}`

Update a Language
PUT`/languages/{language_code}`

Delete a Language
DELETE`/languages/{language_code}`

List All Verbs
GET`/verbs`

List All Verbs of a Language
GET`/verbs/{language_code}`

Find All Verbs Matching a Query String
GET`/verbs?q={query}`

Create a Verb
POST`/verbs`

Get a Verb By ID
GET`/verbs/{id}`

Get a Verb By Language and Infinitive
GET`/verbs/{language_code}/{infinitive}`

Get Translations of a Verb by Language and Infinitive
GET`/verbs/{language_code}/{infinitive}/translations`

Get Translations of a Verb by ID
GET`/verbs/{id}/translations`

Create a Translation of a Verb
POST`/verbs/{language_code}/{infinitive}/translations`

Link Translations of two Verbs
POST`/verbs/{language_code}/{infinitive}/translations/{translation_language_code}`

Update Verb by ID
PUT`/verbs/{id}`

Update Verb by Language Code and Infinitive
PUT`/verbs/{language_code}/{infinitive}`

Delete Verb by ID
DELETE`/verbs/{id}`

Delete Verb by Language Code and Infinitive
DELETE`/verbs/{language_code}/{infinitive}`