---
updatedAt: 2026-05-07T11:57:40.000Z
agentTools:
  projectIndex: https://developer.silverfin.com/llms.txt
---

# Get all custom parameters of a reconciliation for this period

Get all custom parameters of a reconciliation for this period. <br>
<b>Required scope(s):</b> `financials:read`


# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Silverfin API",
    "description": "This is the currently supported stable version of the Silverfin API.\nIt's based on OAuth so you need a `client_id` and `client_secret`\nto connect. This can be requested by a mail to info@getsilverfin.com\n\n## OAuth endpoints\n\n* authorization url: https://live.getsilverfin.com/oauth/authorize\n* access token url: https://live.getsilverfin.com/oauth/token\n\nWhen you redirect to the authorize url, you can pass the requested\nscopes in the url with the `scope` parameter. The scopes should be\nseparated with spaces.\n\n## OAuth flow\n\nWe use standard OAuth. The typical flow goes like this:\n\n1. GET request to oauth/authorize with url parameters: `client_id`, `redirect_uri`, `scope` (a space separated list of requested scopes) and `response_type=code`\n2. This will redirect the browser to a GET request on `redirect_uri` with a url parameter `code`\n3. With this code you can do a server side POST to oauth/token with parameters: `client_id`, `client_secret`, `code`, `redirect_uri` and `grant_type=authorization_code`\n\nAfter following these steps, you will have an access token and a\nrefresh token. The access token is valid for 10 minutes. With the\nrefresh token, you can request a new access token. In the response\nyou get an access token and a new refresh token. The refresh token\ndoesn't expire, but can only be used once.\n\nYou can request a new access token & refresh token by doing\n\n4. POST to to oauth/token with parameters: `client_id`, `client_secret`, `refresh_token`, `redirect_uri` and `grant_type=refresh_token`, so the same as for getting the initial access token, but with another `grant_type` and `refresh_token` instead of `code`\n\n## Scopes\nWe currently support the following scopes: `user:email`, `webhooks`,\n`administration:read`, `administration:write`, `permanent_documents:read`,\n`permanent_documents:write`, `communication:read`, `communication:write`,\n`financials:read`.\n\nThe scopes are also coupled to the application and added to the\napplication based on your needs.\n\n## Postman\n\nThe postman library will provide you with all the endpoints currently available in the Silverfin API.\n\nTo setup the library, just import it directly into your Postman and this should add a new collection called `Silverfin Oauth API Live` into your Postman. In the top right of your Postman a new environment should also be added called `Silverfin Live`. In order to setup the Postman library correctly, you will find a number of variables setup in the environment `client_id` `secret` `access_token` `refresh_token` `expires_at` `callback_url` `firm_id`. The only ones that you need to modify are the `client_id`,`secret`,`firm_id`,and `callback_url`.\n\nOnce you've set these variables, you can click on the `Silverfin OAuth API Live` collection, and you'll find one more variables set up in this collection as well: `base_url`. You don't really need to modify this but if you are working on a sandbox environment from Silverfin, then you have to change the url from `api.getsilverfin.com` towards `sandbox.getsilverfin.com`.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://live.getsilverfin.com"
    }
  ],
  "tags": [
    {
      "name": "Financials"
    }
  ],
  "components": {
    "securitySchemes": {
      "OAuth2": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://live.getsilverfin.com/oauth/authorize",
            "tokenUrl": "https://live.getsilverfin.com/oauth/token",
            "scopes": {
              "administration:read": "",
              "administration:write": "",
              "client_meetings:read": "",
              "client_meetings:external_notes:write": "",
              "communication:read": "",
              "communication:write": "",
              "financials:read": "",
              "financials:write": "",
              "financials:transactions:read": "",
              "financials:transactions:write": "",
              "insights:read": "",
              "insights:write": "",
              "workflows:read": "",
              "workflows:write": "",
              "permanent_documents:read": "",
              "permanent_documents:write": "",
              "webhooks": "",
              "links": "",
              "user:email": "",
              "user:firm": "",
              "user:profile": ""
            }
          }
        }
      }
    }
  },
  "paths": {
    "/api/v4/f/{firm_id}/companies/{company_id}/periods/{period_id}/reconciliations/{reconciliation_id}/custom": {
      "get": {
        "tags": [
          "Financials"
        ],
        "summary": "Get all custom parameters of a reconciliation for this period",
        "description": "Get all custom parameters of a reconciliation for this period. <br>\n<b>Required scope(s):</b> `financials:read`\n",
        "security": [
          {
            "OAuth2": [
              "financials:read"
            ]
          }
        ],
        "operationId": "getReconciliationTextCustomProperties",
        "parameters": [
          {
            "name": "Accept",
            "in": "header",
            "schema": {
              "type": "string"
            },
            "example": "application/json"
          },
          {
            "name": "Accept-Language",
            "in": "header",
            "schema": {
              "type": "string"
            },
            "example": "en"
          },
          {
            "name": "firm_id",
            "in": "path",
            "schema": {
              "type": "integer"
            },
            "required": true
          },
          {
            "name": "company_id",
            "in": "path",
            "schema": {
              "type": "integer"
            },
            "required": true
          },
          {
            "name": "period_id",
            "in": "path",
            "schema": {
              "type": "integer"
            },
            "required": true
          },
          {
            "name": "reconciliation_id",
            "in": "path",
            "schema": {
              "type": "integer"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "namespace": {
                        "type": "string"
                      },
                      "key": {
                        "type": "string"
                      },
                      "value": {
                        "type": "string"
                      },
                      "owner": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "type": {
                            "type": "string"
                          }
                        }
                      },
                      "documents": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "integer"
                            },
                            "file_name": {
                              "type": "string"
                            },
                            "content": {
                              "type": "string"
                            },
                            "download_url": {
                              "type": "string"
                            },
                            "created_by": {
                              "type": "string"
                            }
                          }
                        }
                      },
                      "updated_by_id": {
                        "type": "integer"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```