問い合わせはREST APIエンドポイントを指定して実行することができます。REST APIは主要なHTTPプロトコルに対応しています。そしてこれはクライアントライブラリがビューのデータを取得するのに利用するものと同じシステムです。

REST APIを使用すると、ポート8092上のCouchbase Serverクラスタ内の任意のノードへアクセスして、ビューに問い合わせすることができます。例:

GET http://localhost:8092/bucketname/_design/designdocname/_view/viewname

ここで：

SASLパスワードで保護されたバケット内に格納されているビューにアクセスするとき、リクエストのURLにバケットの名前とパスワードを含めなければなりません。

GET http://bucketname:password@localhost:8092/bucketname/_design/designdocname/_view/viewname

URLリクエストへの追加の引数として、ビューから情報を選択すること、limit(出力するアイテムの数を指定すること)、ソートすることやその他オプションを指定することができます。たとえば、10アイテムだけを出力するには：

GET http://localhost:8092/bucketname/_design/designdocname/_view/viewname?limit=10

URLのフォーマットは、HTTPの仕様に従います。最初の引数は、疑問符(?)を使用して、ベースURLと区切ります。追加の引数は、アンパサンド(&)を使用して、区切ります。特殊文字は、HTTPの標準規則に従って引用符で囲むかエスケープする必要があります。

その他のサポートされている引数は、以下の表に詳述されています。

ビューからの出力は、ビュー内の行数についての情報、および個々のビューの情報を含むJSON構造です。

ビューの結果の例を以下に示します：

{
  "total_rows": 576,
  "rows" : [
      {"value" : 13000, "id" : "James", "key" : ["James", "Paris"] },
      {"value" : 20000, "id" : "James", "key" : ["James", "Tokyo"] },
      {"value" : 5000,  "id" : "James", "key" : ["James", "Paris"] },
…
    ]
}

返されるJSONは2つのフィールドから成ります：

エラーが発生した場合、HTTPレスポンスは、(200ではない)エラーの種類になり、JSONの構造は、基本的なerrorと、より詳細なreasonの2つのフィールドを含んで返されます。例:

{
  "error":"bad_request",
  "reason":"invalid UTF-8 JSON: {{error,{1,\"lexical error: invalid char in json text.\\n\"}},\n                     \"Paris\"}"
}

各パラメータの詳細、および相互作用の特定の領域は、次のセクション内で補足されています。これはすべてのクライアントライブラリインタフェースに適用されます。