---
updatedAt: 2025-06-16T21:07:19.000Z
agentTools:
  projectIndex: https://dev.fio.net/llms.txt
---

# Get Pending FIO Requests

Returns FIO Requests awaiting response by the supplied FIO Public Key.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "x-stoplight": {
    "id": "0arqsww8kj7jl"
  },
  "info": {
    "title": "FIO Chain Getters API",
    "version": "1.9",
    "contact": {
      "url": "http://fioprotocol.io",
      "name": "FIO",
      "email": "getinfo@fioprotocol.io"
    },
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/license/mit/"
    },
    "description": "FIO Chain Getter API offers multiple endpoints design to return information about the FIO Chain or specific FIO Handles, FIO Requests, FIO Data, NFT Signatures, or FIO Chain accounts.\n\nThere are many FIO Chain API servers ran by Block Producers and other entities. For latest server API urls, see https://github.com/fioprotocol/fio.mainnet#fio-api\n\nYou may also choose to run your own FIO Chain API node."
  },
  "servers": [
    {
      "url": "https://test.fio.eosusa.io/v1/chain",
      "description": "Testnet"
    },
    {
      "url": "https://fio.blockpane.com/v1/chain",
      "description": "Mainnet"
    }
  ],
  "tags": [
    {
      "name": "FIO Request",
      "description": "API calls to return information about FIO Requests"
    }
  ],
  "paths": {
    "/get_pending_fio_requests": {
      "parameters": [],
      "post": {
        "summary": "Get Pending FIO Requests",
        "operationId": "get_pending_fio_requests",
        "responses": {
          "200": {
            "$ref": "#/components/responses/ResponseFIORequestWOstatusArray"
          },
          "400": {
            "$ref": "#/components/responses/Error400"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          }
        },
        "description": "Returns FIO Requests awaiting response by the supplied FIO Public Key.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fio_public_key": {
                    "$ref": "#/components/schemas/fio_public_key"
                  },
                  "limit": {
                    "$ref": "#/components/schemas/limit"
                  },
                  "offset": {
                    "$ref": "#/components/schemas/offset"
                  }
                },
                "required": [
                  "fio_public_key"
                ]
              },
              "examples": {
                "Example 1": {
                  "value": {
                    "fio_public_key": "FIO8h1Aan6DZJsFjH91BGsQfNt2FsYbVyKeXFETNvYtTW9vaU81ay"
                  }
                }
              }
            }
          },
          "description": ""
        },
        "tags": [
          "FIO Request"
        ],
        "x-stoplight": {
          "id": "ghyrng1t02ql1"
        }
      }
    }
  },
  "components": {
    "schemas": {
      "chain_code": {
        "title": "chain_code",
        "x-stoplight": {
          "id": "69yzx53q2rtv6"
        },
        "type": "string",
        "pattern": "^[A-Z0-9]+$",
        "minLength": 1,
        "maxLength": 10,
        "description": "See [Chain and token code standard](https://github.com/fioprotocol/fips/blob/master/fip-0015.md)",
        "default": "ETH",
        "example": "ETH"
      },
      "token_code": {
        "title": "token_code",
        "x-stoplight": {
          "id": "8rji4bicvtnov"
        },
        "type": "string",
        "description": "See [Chain and token code standard](https://github.com/fioprotocol/fips/blob/master/fip-0015.md)",
        "minLength": 1,
        "maxLength": 10,
        "example": "USDT",
        "pattern": "^[A-Z0-9]+$",
        "default": "USDT"
      },
      "fio_public_key": {
        "title": "fio_public_key",
        "x-stoplight": {
          "id": "ufh5rj24fut9p"
        },
        "type": "string",
        "example": "FIO8PRe4WRZJj5mkem6qVGKyvNFgPsNnjNN6kPhh6EaCpzCVin5Jj",
        "description": "Valid WIF Public Key with FIO Prefix.",
        "default": "FIO8PRe4WRZJj5mkem6qVGKyvNFgPsNnjNN6kPhh6EaCpzCVin5Jj"
      },
      "limit": {
        "title": "limit",
        "x-stoplight": {
          "id": "mbjn2osp4rhb0"
        },
        "type": "integer",
        "description": "Number of requests to return. If omitted, all requests will be returned."
      },
      "offset": {
        "title": "offset",
        "x-stoplight": {
          "id": "o73697wsk21fk"
        },
        "type": "integer",
        "description": "First request from list to return. If omitted, 0 is assumed."
      },
      "more": {
        "title": "more",
        "x-stoplight": {
          "id": "kqlfcggh9uanu"
        },
        "type": "integer",
        "description": "true - there are more results; false - there are no more results."
      },
      "FIORequest_content": {
        "title": "FIORequest_content",
        "x-stoplight": {
          "id": "fkt3yhcsxj0rj"
        },
        "type": "object",
        "description": "**This object is encrypted!** You will only see encrypted blob, until you decrypt the contents.\n\nSee [Encryption in FIO Request and FIO Data Guide](/docs/encryption-in-fio-request-and-fio-data) for more information.",
        "properties": {
          "payer_public_address": {
            "type": "string",
            "x-stoplight": {
              "id": "v4brm3j6jfco1"
            },
            "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
            "minLength": 1,
            "maxLength": 128,
            "description": "Public address where funds should be sent."
          },
          "amount": {
            "type": "string",
            "x-stoplight": {
              "id": "d4omeyuj3libb"
            },
            "description": "Amount of funds requested."
          },
          "chain_code": {
            "$ref": "#/components/schemas/chain_code"
          },
          "token_code": {
            "$ref": "#/components/schemas/token_code"
          },
          "memo": {
            "type": "string",
            "x-stoplight": {
              "id": "om6qq8lzfcen7"
            },
            "description": "Free-form text memo"
          },
          "hash": {
            "type": "string",
            "x-stoplight": {
              "id": "6rnl59o130or0"
            },
            "description": "Hash of offline data associated with the request."
          },
          "offline_url": {
            "type": "string",
            "x-stoplight": {
              "id": "4bejebkinm0tk"
            },
            "description": "Offline URL where to find offline data associated with the request."
          },
          "future_use1": {
            "type": "string",
            "x-stoplight": {
              "id": "6ce9w34zpisaz"
            }
          },
          "future_use2": {
            "type": "string",
            "x-stoplight": {
              "id": "2y1uui3mvc26n"
            }
          },
          "future_use3": {
            "type": "string",
            "x-stoplight": {
              "id": "cyk9qra6vacod"
            }
          },
          "future_use4": {
            "type": "string",
            "x-stoplight": {
              "id": "kcqhf8u6ixlgr"
            }
          },
          "future_use5": {
            "type": "string",
            "x-stoplight": {
              "id": "jay4n7yjgmze5"
            }
          }
        },
        "x-internal": false
      },
      "payer_fio_address": {
        "title": "payer_fio_address",
        "x-stoplight": {
          "id": "nt11049yz29l7"
        },
        "type": "string",
        "pattern": "^(?:(?=.{3,64}$)[a-zA-Z0-9]{1}(?:(?!-{2,}))[a-zA-Z0-9-]*(?:(?<!-))@[a-zA-Z0-9]{1}(?:(?!-{2,}))[a-zA-Z0-9-]*(?:(?<!-))$)",
        "description": "FIO Handle of the Payer, also known as the receiver of the FIO Request.",
        "minLength": 3,
        "maxLength": 64,
        "example": "vitalik@safu"
      },
      "payee_fio_address": {
        "title": "payee_fio_address",
        "x-stoplight": {
          "id": "7bxmehz2xw1xm"
        },
        "type": "string",
        "pattern": "^(?:(?=.{3,64}$)[a-zA-Z0-9]{1}(?:(?!-{2,}))[a-zA-Z0-9-]*(?:(?<!-))@[a-zA-Z0-9]{1}(?:(?!-{2,}))[a-zA-Z0-9-]*(?:(?<!-))$)",
        "minLength": 3,
        "maxLength": 64,
        "example": "vitalik@safu",
        "description": "FIO Handle of the Payee, also known as the sender of the FIO Request."
      },
      "payer_fio_public_key": {
        "title": "payer_fio_public_key",
        "x-stoplight": {
          "id": "w90vhdmlx5uox"
        },
        "type": "string",
        "description": "FIO Public Key of the Payer at the time when FIO Request was sent. This is used as input to decrypt the content of the request."
      },
      "payee_fio_public_key": {
        "title": "payer_fio_public_key",
        "x-stoplight": {
          "id": "4k5zxjqd1702u"
        },
        "type": "string",
        "description": "FIO Public Key of the Payee at the time when FIO Request was sent. This is used as input to decrypt the content of the request."
      }
    },
    "responses": {
      "Error400": {
        "description": "HTTP code 400 is returned when request was malformed or contained improper values. The response body will indicate the name of the incorrect field, its type, and the value the service received.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "type": {
                  "x-stoplight": {
                    "id": "4j4mgwukbxxa7"
                  },
                  "type": "string",
                  "default": "invalid_input"
                },
                "message": {
                  "type": "string",
                  "x-stoplight": {
                    "id": "lqhqbc71twejf"
                  },
                  "default": "An invalid request was sent in, please check the nested errors for details."
                },
                "fields": {
                  "type": "object",
                  "x-stoplight": {
                    "id": "u984g5pvenewm"
                  },
                  "properties": {
                    "name": {
                      "type": "string",
                      "x-stoplight": {
                        "id": "9nj27sjxp11mq"
                      }
                    },
                    "value": {
                      "type": "string",
                      "x-stoplight": {
                        "id": "fkejlq13tyxfk"
                      }
                    },
                    "error": {
                      "type": "string",
                      "x-stoplight": {
                        "id": "nurkwro0d4spc"
                      }
                    }
                  }
                }
              }
            },
            "examples": {
              "Invalid FIO Address": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "fio_address",
                    "value": "bob",
                    "error": "Invalid FIO Address"
                  }
                }
              },
              "Invalid Chain Code": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "chain_code",
                    "value": "+",
                    "error": "Invalid Chain Code"
                  }
                }
              },
              "Invalid Token Code": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "token_code",
                    "value": "",
                    "error": "Invalid Token Code"
                  }
                }
              },
              "Invalid Limit": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "limit",
                    "value": "x",
                    "error": "Invalid limit"
                  }
                }
              },
              "Invalid Offset": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "offset",
                    "value": "x",
                    "error": "Invalid offset"
                  }
                }
              },
              "FIO Address does not exist": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "fio_address",
                    "value": "bob@empty",
                    "error": "FIO Address does not exist"
                  }
                }
              },
              "Invalid Contract Address": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "contract_address",
                    "value": "0123456789012345678901234567890123456789012345678901234567890123456789",
                    "error": "Invalid Contract Address"
                  }
                }
              },
              "Invalid FIO Public Key": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "fio_public_key",
                    "value": "FIO123",
                    "error": "Invalid FIO Address"
                  }
                }
              },
              "Invalid FIO Name": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "fio_name",
                    "value": "_.@",
                    "error": "Invalid FIO Name"
                  }
                }
              },
              "Invalid account": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "account",
                    "value": "!@#$",
                    "error": "Format of FIO Account not valid."
                  }
                }
              },
              "Invalid Grantee Account": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "grantee_account",
                    "value": "-123",
                    "error": "Invalid account."
                  }
                }
              },
              "Invalid Object Name": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "object_name",
                    "value": "123",
                    "error": "Object Name is invalid."
                  }
                }
              },
              "Invalid Permission Name": {
                "value": {
                  "type": "invalid_input",
                  "message": "An invalid request was sent in, please check the nested errors for details.",
                  "fields": {
                    "name": "permission_name",
                    "value": "123",
                    "error": "Permission Name is invalid."
                  }
                }
              }
            }
          }
        }
      },
      "Error404": {
        "description": "HTTP code 404 is returned when the requested information could not be found.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "x-stoplight": {
                    "id": "bok8iqdel2p7x"
                  }
                }
              }
            },
            "examples": {
              "Public key not found": {
                "value": {
                  "message": "Public key not found"
                }
              },
              "NFTs not found": {
                "value": {
                  "message": "NFTs not found"
                }
              },
              "No FIO Addresses": {
                "value": {
                  "message": "No FIO Addresses"
                }
              },
              "No FIO Domains": {
                "value": {
                  "message": "No FIO Domains"
                }
              },
              "No lock tokens in account": {
                "value": {
                  "message": "No lock tokens in account"
                }
              },
              "Account not found": {
                "value": {
                  "message": "Account not found"
                }
              },
              "No permissions": {
                "value": {
                  "message": "Permissions not found."
                }
              }
            }
          }
        }
      },
      "ResponseFIORequestWOstatusArray": {
        "description": "Returns FIO Requests.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "requests": {
                  "type": "array",
                  "items": {
                    "x-stoplight": {
                      "id": "j4c40x99ldgj9"
                    },
                    "type": "object",
                    "properties": {
                      "fio_request_id": {
                        "type": "integer",
                        "x-stoplight": {
                          "id": "r7a8j3txikg87"
                        },
                        "description": "ID of the original request"
                      },
                      "payer_fio_address": {
                        "$ref": "#/components/schemas/payer_fio_address"
                      },
                      "payee_fio_address": {
                        "$ref": "#/components/schemas/payee_fio_address"
                      },
                      "payer_fio_public_key": {
                        "$ref": "#/components/schemas/payer_fio_public_key"
                      },
                      "payee_fio_public_key": {
                        "$ref": "#/components/schemas/payee_fio_public_key"
                      },
                      "content": {
                        "x-stoplight": {
                          "id": "k0ruoh0okgmwu"
                        },
                        "description": "**This object is encrypted!** You will only see encrypted blob, until you decrypt the contents.",
                        "oneOf": [
                          {
                            "$ref": "#/components/schemas/FIORequest_content"
                          },
                          {
                            "type": "string",
                            "x-stoplight": {
                              "id": "h9ratfwil46hb"
                            },
                            "description": "The content field call will return a string which represents an encrypted object as defined above."
                          }
                        ]
                      },
                      "time_stamp": {
                        "type": "string",
                        "x-stoplight": {
                          "id": "pfco4coqrodae"
                        },
                        "format": "date-time",
                        "description": "Date-time when request was submitted."
                      }
                    },
                    "required": [
                      "fio_request_id",
                      "payer_fio_address",
                      "payee_fio_address",
                      "payer_fio_public_key",
                      "payee_fio_public_key",
                      "content",
                      "time_stamp"
                    ]
                  }
                },
                "more": {
                  "$ref": "#/components/schemas/more"
                }
              },
              "required": [
                "requests",
                "more"
              ]
            },
            "examples": {
              "Example 1": {
                "value": {
                  "requests": [
                    {
                      "fio_request_id": 457,
                      "payer_fio_address": "pm@fiotestnet",
                      "payee_fio_address": "pm110@regtest",
                      "payer_fio_public_key": "FIO8h1Aan6DZJsFjH91BGsQfNt2FsYbVyKeXFETNvYtTW9vaU81ay",
                      "payee_fio_public_key": "FIO6sdMSmMD6LFLfo5BXPCf16pRzGj9SxNqgvuuyvw4XfmD89LCW2",
                      "content": "/uG5gLQvjPptxyLESBlIWmTxlbTVcCBkhJhnPWpljH0fCflgMKgf48S8ylST7Jr5blaLuNxgneYpHVcnz77sh9ShyIpUxc+lAo7qNH1O2eZ8RE+19VbIsqc0JWW6HUul7FKbW61qRty6KS6EMWMLBUszBimTzxF25Acurx2O9rc=",
                      "time_stamp": "2020-09-01T15:38:03"
                    },
                    {
                      "fio_request_id": 1245,
                      "payer_fio_address": "pm@fiotestnet",
                      "payee_fio_address": "kir2@fiotestnet",
                      "payer_fio_public_key": "FIO8h1Aan6DZJsFjH91BGsQfNt2FsYbVyKeXFETNvYtTW9vaU81ay",
                      "payee_fio_public_key": "FIO67fELa4N8pLNJFGLnDwqLhiUo1zf5A1gwsTD8muoSDYmTUQSF6",
                      "content": "AAAAAAAAAAAAAAAAAAAAAONVHKBT0OSmW7EuodhSbxpTz+o58g1DJ03uU3bW2PLfucMmy6MWPcsHHfsx/PELP3bFTM3JxzGsywEkE51l2UM=",
                      "time_stamp": "2020-10-20T10:22:00"
                    },
                    {
                      "fio_request_id": 1250,
                      "payer_fio_address": "pm@fiotestnet",
                      "payee_fio_address": "kir2@fiotestnet",
                      "payer_fio_public_key": "FIO8h1Aan6DZJsFjH91BGsQfNt2FsYbVyKeXFETNvYtTW9vaU81ay",
                      "payee_fio_public_key": "FIO67fELa4N8pLNJFGLnDwqLhiUo1zf5A1gwsTD8muoSDYmTUQSF6",
                      "content": "AAAAAAAAAAAAAAAAAAAAAOlElM6jERL53jpucuO0iIjvu18orLjwId8dVtGEUjiIgK5Ejh4HOuoVRUOcnH1Vv1aaawVpeMH3Sz1Y26aILwfQOE5vaOVfsUEqOJCmcaWotUMHtsIq7XNHYmF81e6qFw==",
                      "time_stamp": "2020-10-21T09:48:08"
                    },
                    {
                      "fio_request_id": 1257,
                      "payer_fio_address": "pm@fiotestnet",
                      "payee_fio_address": "kir2@fiotestnet",
                      "payer_fio_public_key": "FIO8h1Aan6DZJsFjH91BGsQfNt2FsYbVyKeXFETNvYtTW9vaU81ay",
                      "payee_fio_public_key": "FIO67fELa4N8pLNJFGLnDwqLhiUo1zf5A1gwsTD8muoSDYmTUQSF6",
                      "content": "AAAAAAAAAAAAAAAAAAAAAOlElM6jERL53jpucuO0iIjvu18orLjwId8dVtGEUjiIixIq0ec42C9d+4ameHrwEHF85kXNa9ar1sZEKn6hvZbOO4hlv4Q1m363uOGBv8tNQ+RmSctBZ+8cvCoIbp9+sg==",
                      "time_stamp": "2020-10-21T13:16:36"
                    },
                    {
                      "fio_request_id": 1258,
                      "payer_fio_address": "pm@fiotestnet",
                      "payee_fio_address": "kir3@fiotestnet",
                      "payer_fio_public_key": "FIO8h1Aan6DZJsFjH91BGsQfNt2FsYbVyKeXFETNvYtTW9vaU81ay",
                      "payee_fio_public_key": "FIO6g2P53WGVcKAnws53j1oZz2LJDJSzsKNn5vHmQTYswfGyHxTZD",
                      "content": "AAAAAAAAAAAAAAAAAAAAAKoOxv3+SxAlDtKRq43FaG2IT9vWhKvqbuprJ7KPMGP8RpD5e4loV1b2GppgBSb2KnL2ny+KQvxUrluWN2y7tYCexq4sjlXm54axkXGW9OEH8sGaBjxVAfMDY8AV373LgQ==",
                      "time_stamp": "2020-10-21T14:18:48"
                    }
                  ],
                  "more": 0
                }
              }
            }
          }
        }
      }
    }
  },
  "security": [],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```