curl --header "PRIVATE-TOKEN: QVy1PB7sTxfy4pqfZM1U" --header "SUDO: 23" "http://example.com/api/v3/projects"
```
-#### Pagination
+## Pagination
When listing resources you can pass the following parameters:
+ `page` (default: `1`) - page number
+ `per_page` (default: `20`, max: `100`) - number of items to list per page
+## id vs iid
+
+When you work with API you may notice two similar fields in api entites: id and iid.
+The main difference between them is scope. Example:
+
+Issue
+ id: 46
+ iid: 5
+
+* id - is uniq across all Issues table. It used for any api calls.
+* iid - is uniq only in scope of single project. When you browse issues or merge requests with Web UI - you see iid.
+
+So if you want to get issue with api you use `http://host/api/v3/.../issues/:id.json`
+But when you want to create a link to web page - use `http:://host/project/issues/:iid.json`
+
+
+
## Contents
+ [Users](users.md)
[
{
"id": 43,
+ "iid": 3,
"project_id": 8,
"title": "4xx/5xx pages",
"description": "",
},
{
"id": 42,
+ "iid": 4,
"project_id": 8,
"title": "Add user settings",
"description": "",
```json
{
"id": 42,
+ "iid": 3,
"project_id": 8,
"title": "Add user settings",
"description": "",