RentRollAPI.Client

Official .NET client for RentRollAPI — convert commercial real estate rent rolls (PDF, Excel, CSV, scans) into structured, verified data with one call.

Every extraction includes a deterministic verification report: totals recomputed from extracted units are reconciled against the totals stated on the document, unit counts are cross-checked, and any uncertain field is flagged with a confidence score — never silently guessed.

Install

Code

dotnet add package RentRollAPI.Client

Quick start

csharp

using RentRollApi.Client;

using var client = new RentRollClient("rr_live_your_key");

var result = await client.ExtractAsync("rent-roll.pdf");

Console.WriteLine($"{result.PropertyName?.Value}: {result.Units.Count} units");
Console.WriteLine($"Confidence: {result.Verification.DocumentConfidence:P0}, all checks passed: {result.Verification.AllChecksPassed}");

foreach (var unit in result.Units)
    Console.WriteLine($"  {unit.UnitNumber?.Value,-8} {unit.TenantName?.Value,-24} {unit.MonthlyRent?.Value,10:C}");

foreach (var check in result.Verification.Checks)
    Console.WriteLine($"  [{check.Result}] {check.Name}: {check.Detail}");

Excel / CSV output

csharp

byte[] xlsx = await client.ExtractToXlsxAsync(fileStream, "rent-roll.pdf");
string csv  = await client.ExtractToCsvAsync(fileStream, "rent-roll.pdf");

T12 / operating statements

csharp

var t12 = await client.ExtractOperatingStatementAsync("t12.pdf");

Console.WriteLine($"{t12.PropertyName?.Value} — {t12.Months.Count} months, {t12.LineItems.Count} line items");
foreach (var item in t12.LineItems)
    Console.WriteLine($"  [{item.Kind,-8}] {item.Label?.Value,-30} {item.Total?.Value,12:C} ({item.Category})");

// Deterministic checks: row totals vs monthly values, EGI, Total OpEx, and NOI reconciliation.
Console.WriteLine($"All checks passed: {t12.Verification.AllChecksPassed}");

ExtractOperatingStatementToXlsxAsync / ExtractOperatingStatementToCsvAsync return file output, mirroring the rent-roll methods.

With IHttpClientFactory

csharp

services.AddHttpClient("rentroll", c => c.Timeout = TimeSpan.FromMinutes(5));
// ...
var client = new RentRollClient(httpClientFactory.CreateClient("rentroll"), apiKey);

Error handling

csharp

try
{
    var result = await client.ExtractAsync("statement.pdf");
}
catch (RentRollApiException ex) when (ex.StatusCode == HttpStatusCode.UnprocessableEntity)
{
    // 422: corrupt, password-protected, or not a supported document
    Console.WriteLine(ex.Message);
}
catch (RentRollApiException ex) when ((int)ex.StatusCode == 429)
{
    // Monthly quota exceeded and no prepaid credits remain
}

MCP server (AI assistants)

RentRollAPI also runs a hosted Model Context Protocol server — no install required. Point any MCP-capable client (Claude, Cursor, VS Code Copilot, ...) at the streamable-HTTP endpoint and it gains an extract_rent_roll tool:

config.json

{
  "mcpServers": {
    "rentrollapi": {
      "type": "http",
      "url": "https://rentrollapi.com/mcp",
      "headers": { "X-Api-Key": "rr_live_your_key" }
    }
  }
}

Omit the header to use the free 3-docs/day demo allowance.

Getting an API key

Plans start at $49/month (50 documents) with a free 3-docs/day demo at rentrollapi.com/app — no signup needed to try it.

Documents are processed in memory and never retained.