Skip to main content
POST
アクセス可能なプロジェクトを、ページ分割、名前検索、言語・状態フィルター付きで一覧表示します。チームのゲストに表示されるのは、自分が API で作成したプロジェクトのみです。

​
認証と権限

​
string
必須
このヘッダーに VoiceCheap API キーを指定してください。同じ API キーを Authorization: Bearer で送信することもできます。OAuth アクセストークンは MCP でのみ使用でき、この REST エンドポイントでは使用できません。
必要な権限: projects:read. 有効な有料サブスクリプションが必要です。権限によってチーム内のロール、リソースの所有権、メディアクレジット、プランの制限が変わることはありません。

​
パラメーター

​
string
テキスト値。最小文字数: 1. 最大文字数: 200.
​
integer
整数値。最小値: 0. 最大値: 100000. デフォルト値: 0.
​
integer
整数値。最小値: 1. 最大値: 50. デフォルト値: 20.
​
string
テキスト値。許容値: “afrikaans”, “albanian”, “amharic”, “arabic”, “armenian”, “assamese”, “azerbaijani”, “basque”, “belarusian”, “bengali”, “bosnian”, “bulgarian”, “catalan”, “croatian”, “czech”, “danish”, “dutch”, “english”, “british english”, “estonian”, “finnish”, “french”, “french canadian”, “galician”, “german”, “greek”, “gujarati”, “hebrew”, “hindi”, “hungarian”, “icelandic”, “indonesian”, “irish”, “italian”, “japanese”, “kannada”, “kazakh”, “khmer”, “korean”, “lao”, “latvian”, “lithuanian”, “macedonian”, “malay”, “malayalam”, “mandarin”, “marathi”, “mongolian”, “nepali”, “norwegian”, “persian”, “polish”, “portuguese”, “brazilian portuguese”, “pt_brazil”, “punjabi”, “romanian”, “russian”, “serbian”, “slovak”, “slovenian”, “spanish”, “swahili”, “swedish”, “tagalog”, “tamil”, “telugu”, “thai”, “turkish”, “ukrainian”, “urdu”, “vietnamese”, “welsh”, “yoruba”, “zulu”.
​
string
テキスト値。許容値: “af”, “sq”, “am”, “ar”, “hy”, “as”, “ast”, “az”, “ba”, “eu”, “be”, “bn”, “bs”, “br”, “bg”, “my”, “ca”, “ceb”, “zh”, “hr”, “cs”, “da”, “nl”, “en”, “eo”, “at”, “et”, “fil”, “fo”, “fi”, “fr”, “fr-CA”, “fy”, “ff”, “gd”, “gl”, “lg”, “ka”, “de”, “el”, “gu”, “ht”, “ha”, “haw”, “he”, “hi”, “hu”, “is”, “ig”, “ilo”, “id”, “ia”, “ga”, “it”, “ja”, “jv”, “kea”, “kn”, “kk”, “km”, “kur”, “kir”, “ko”, “lo”, “la”, “luo”, “lv”, “lb”, “ln”, “lt”, “mk”, “mg”, “ms”, “ml”, “mt”, “mi”, “mr”, “mo”, “mn”, “ne”, “no”, “nn”, “nso”, “nya”, “oc”, “or”, “pa”, “ps”, “fa”, “pl”, “pt”, “ro”, “ru”, “sa”, “sr”, “sn”, “sd”, “si”, “sk”, “sl”, “so”, “es”, “su”, “sw”, “ss”, “sv”, “tl”, “tg”, “ta”, “tt”, “te”, “th”, “bo”, “tn”, “tr”, “tk”, “ug”, “uk”, “umb”, “ur”, “uz”, “vi”, “cy”, “wo”, “xh”, “yi”, “yo”, “zu”, “cmn”, “yue”, “en-GB”, “en-US”, “en-AU”, “auto-detect”.
​
string
テキスト値。許容値: “awaitingProofreading”, “translated”, “failed”.
​
string
テキスト値。許容値: “newestFirst”, “oldestFirst”. デフォルト値: “newestFirst”.
​
string
テキスト値。最小文字数: 1. 最大文字数: 200. パターン: ^[^/\\]+$.
以下の JSON Schema は、ディスカバリーで公開される正確なフィールド名、ネストされた型、デフォルト値、範囲、許容値を保持しています。フィールド間の追加ルールは操作の注意事項に記載されています。

​
リクエスト例

例に記載されたリソース識別子とメディアキーを、ご自身のアカウントで返された値に置き換えてください。同じ変更操作を再試行する場合は、リクエスト識別子を変更しないでください。

​
レスポンス

初回実行が成功すると、操作結果を data に格納して HTTP 200 を返します。同じリクエストを再送した場合は、代わりに保存済みリクエストの状態を返すことがあります。例はサポートされるレスポンスの一例であり、すべての任意フィールドを示すものではありません。 アクセス可能なプロジェクト概要を1ページ分と、オフセットページネーションのメタデータを返します。

​
結果フィールド

​
操作の注意事項

  • offset のデフォルトは 0、limit は 20（最大 50）、sort は newestFirst です。query はプロジェクト名を検索し、folderId、ソース言語、翻訳先言語、status は一覧を絞り込みます。
  • 返されるプロジェクトのフィールドは projectId、projectName、originalLanguage、targetLanguages、duration、createdAt、progressStep、folderId です。未保存の任意フィールドは省略される場合があります。targetLanguages のデフォルトは []、duration は0、folderId は null です。
  • nextOffset は、基盤データから取得したページに limit 件の項目が含まれる場合に設定されます。総件数を示すものではなく、アクセス可能な次の結果の存在も保証しません。
  • チームゲストが閲覧できるのは、同じチーム内で、そのメンバー自身が API 経由で作成したプロジェクトのみです。絞り込みにより、nextOffset があっても projects 配列の件数が少なくなる場合があります。
  • originalLanguage には fr や en などの元言語コード（対応する場合は auto-detect）を指定します。targetLanguage には english などの対応する翻訳先言語名を指定します。

​
使用量

正常に実行された呼び出しごとに、月間 API/MCP 呼び出し回数を 1 回消費します。メディアクレジットと、その操作固有の生成枠も適用されます。

​
エラー