ProZ.com global directory of translation services
The translation workplace
Ideas

GET: /kudoz/:id

Get a single KudoZ record by ID, along with its translations, etc.

Required authorization scope

When using OAuth2 access tokens, the kudoz.read or kudoz.all scope is required to get KudoZ records. See scopes in the authentication guide for information about how to request this scope of authorization.

Parameters

  • id: The KudoZ record ID.

Example request

curl -H "Authorization: Bearer {OAUTH2_ACCESS_TOKEN}" https://api.proz.com/v2/kudoz/123

Response

A JSON object with the following properties:

  • kudoz: The requested KudoZ record.
  • translations: A list of suggested KudoZ translations.
  • users: A list of User summaries for referenced users.
  • meets_translator_requirements: Information about whether the authenticated user meets the requirements for suggesting a translation. (The user is not allowed to suggest a translation if meets_requirements is false. See messages for a list of reasons why translator requirements were not met, if applicable.)
{
  "kudoz": {
  "id": 123,
  "self_link": "https://api.proz.com/v2/kudoz/123",
  "time_created": "2016-02-20T22:07:51+00:00",
  "time_published": "2016-02-20T22:13:06+00:00",
  "status": "open",
  "level": "pro",
  "language_pair": "eng_fra",
  "preferred_language": "eng",
  "created_by": {
    "name": "John Snow",
    "user": "https://api.proz.com/v2/users/32a9a4d0-cb6e-463f-a0ab-63d0a0418bc7"
  },
  "source_term": "over-proportionality in systemic exposure",
  "disc_gen_id": 3,
  "disc_spec_id": 95,
  "disc_write_in": "étude clinique/anticance",
  "context": "Doses should not be doubled because with daily doses over the 2.5 mg recommended dose, over-proportionality in systemic exposure was observed (see section Pharmacokinetics).",
  "no_points": false,
  "may_offend": false,
  "from_test": false,
  "from_non_pro": false,
  "auto_close": false,
  "translator_requirements": {
    "native_language": null,
    "language_pair_level": null,
    "disc_level": null,
    "members_only": null
  },
  "num_translations": 3,
  "selected_translation": "https://api.proz.com/v2/kudoz/123/translations/3467",
  "glossary_entry": {
    "source_term": "over-proportionality in systemic exposure",
    "target_term": "over-proportionnalité de l'exposition systémique"
  },
  "suggested_translations": "https://api.proz.com/v2/kudoz/123/translations",
  "comments": "https://api.proz.com/v2/kudoz/123/comments"
},
  "meets_translator_requirements": {
    "user": "https://api.proz.com/v2/users/32a9a4d0-cb6e-463f-a0ab-63d0a0418bc7",
    "kudoz_record": "https://api.proz.com/v2/kudoz/123",
    "meets_requirements": true,
    "messages": []
  },
  "translations": [
    {
  "id": 3467,
  "self_link": "https://api.proz.com/v2/kudoz/123/translations/3467",
  "kudoz_record_id": 123,
  "kudoz_record_link": "https://api.proz.com/v2/kudoz/123",
  "translator": "https://api.proz.com/v2/users/32a9a4d0-cb6e-463f-a0ab-63d0a0418bc7",
  "time_posted": "2016-02-20T22:38:32+00:00",
  "time_updated": "2016-02-21T09:17:21+00:00",
  "confidence": 4,
  "source_term": "over-proportionality in systemic exposure",
  "translated_term": "over-proportionnalité de l'exposition systémique",
  "language": "fra",
  "explanation": "J'ai répondu pour donner des idées à d'autres ... en tendant des perches... s'agissant d'un plan de financement. Le contexte est insuffisant compte tenu du type de question. Proportionalité par rapport à quoi? J'ai l'impression que la réponse vient ultérieurement ... dans la phrase suivante",
  "reference_urls": [
    "http://example.com/1",
    "http://example.com/2"
  ],
  "example_sentences": [
    "Here's an example of the term used in a sentence."
  ],
  "definition": null,
  "notify_of_peer_review": true,
  "selected": false,
  "selection_comment": null,
  "points_awarded": 0,
  "auto_selected": false,
  "declined": false,
  "hidden": false,
  "hide_reason": null,
  "peer_review_summary": {
    "agrees": 5,
    "disagrees": 1,
    "neutral": 2
  }
}  ],
  "users": [
    {
  "self_link": "https://api.proz.com/v2/users/32a9a4d0-cb6e-463f-a0ab-63d0a0418bc7",
  "uuid": "32a9a4d0-cb6e-463f-a0ab-63d0a0418bc7",
  "site_name": "John Snow",
  "account_type": 2,
  "freelancer_profile_link": "https://api.proz.com/v2/freelancer/32a9a4d0-cb6e-463f-a0ab-63d0a0418bc7",
  "profile_url": "http://www.proz.com/profile/46745",
  "image_url": "http://www.proz.com/profile_resources/100/41429_r520ea700e7876.jpg",
  "is_proz_member": true,
  "proz_membership_type": "individual",
  "is_cpn": true,
  "cpn_language_pair": "ita_eng",
  "native_languages": [ "eng" ],
  "timezone": "America/New_York",
  "country": "us",
  "skype": "johnsnow"
}
  ]
}