Calculadoras Financeiras SA API

API ID 12762

Um conjunto abrangente de calculadoras financeiras sul-africanas cobrindo custos de títulos e propriedades, financiamento de veículos, imposto PAYE, VAT, montantes de aposentadoria, empréstimos pessoais e inflação. Todos os valores monetários em ZAR. Cobre 25 pontos finais nos módulos de títulos, veículos, impostos e finanças pessoais. Dados obtidos da SARS, LPC, Gazeta do Governo, SARB e Stats SA

187 ms resp. média

Documentação da API

Endpoints

Requisição
Retorna o status de saúde atual da API incluindo número da versão, tempo de atividade em segundos e ambiente. Use este ponto de extremidade para verificar se a API está ativa antes de fazer solicitações de cálculo
Endpoint ID: 24863
GET https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24863/health+check
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"version":"1.0.0","uptime_seconds":137620,"environment":"production"}}
Verificação de Saúde — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24863/health+check' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição

Calcula o pagamento mensal do empréstimo, o total do pagamento e os juros totais para um empréstimo habitacional sul-africano usando amortização padrão. Retorna uma análise completa incluindo principal, entrada, prazo e taxa de juros. Corpo da Solicitação: - preço_imóvel (obrigatório): Preço de compra do imóvel em Rands. - entrada (opcional): Valor da entrada em Rands. Padrão é 0 se não for fornecido. - prazo_anos (obrigatório): Prazo do empréstimo em anos. Exemplo: 20. - taxa_juros_anual (obrigatório): Taxa de juros anual em forma de porcentagem. Exemplo: 10,25.

Endpoint ID: 24864
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24864/bond+repayment+calculator
PARÂMETROS DE ENTRADA

Calculadora de Reembolso de Títulos — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"monthly_repayment":17669.58,"principal":1800000,"deposit":200000,"property_price":2000000,"total_repayment":4240699.2,"total_interest":2440699.2,"term_months":240,"term_years":20,"annual_interest_rate":10.25},"meta":{"tax_year":"2026/27","disclaimer":"Estimates only. Consult a qualified financial advisor before making any property or financial decisions.","cached":false}}
Calculadora de Reembolso de Títulos — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24864/bond+repayment+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "property_price": 2000000,
  "deposit": 200000,
  "term_years": 20,
  "annual_interest_rate": 10.25
}'

    
Requisição

Calcula o preço máximo da propriedade que um comprador pode pagar com base na renda mensal bruta Usa a relação de acessibilidade padrão de 30 por cento aplicada pelos bancos da África do Sul Retorna o preço máximo da propriedade o valor máximo do empréstimo e a máxima prestação mensal Corpo da solicitação: - renda_mensal_bruta (obrigatório): Renda mensal bruta antes das deduções em Rands - depósito (opcional): Quantia disponível para depósito em Rands Padrão para 0 se não fornecido - prazo_anos (obrigatório): Prazo do empréstimo em anos Exemplo: 20 - taxa_de_juros_anual (obrigatório): Taxa de juros anual como porcentagem Exemplo: 10,25

Endpoint ID: 24865
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24865/bond+affordability+calculator
PARÂMETROS DE ENTRADA

Calculadora de Acessibilidade de Títulos — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"max_property_price":1628049.82,"max_loan_amount":1528049.82,"max_monthly_repayment":15000,"deposit":100000,"gross_monthly_income":50000,"affordability_ratio":0.3,"term_years":20,"annual_interest_rate":10.25},"meta":{"tax_year":"2026/27","disclaimer":"Estimates only. Consult a qualified financial advisor before making any property or financial decisions.","cached":false,"notes":"Max monthly repayment is capped at 30% of gross monthly income. Individual banks may apply stricter qualifying criteria and will assess net income, existing debt, and credit profile."}}
Calculadora de Acessibilidade de Títulos — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24865/bond+affordability+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "gross_monthly_income": 50000,
  "deposit": 100000,
  "term_years": 20,
  "annual_interest_rate": 10.25
}'

    
Requisição
Calcula o custo total de transferir uma propriedade na África do Sul Inclui o imposto de transferência da SARS usando o sistema de faixas em vigor honorários de advogados de transferência também conhecidos como honorários de escritura com base na tarifa orientadora da LPC taxas de transferência do registro de imóveis do Diário da República taxa de apresentação e despesas
Endpoint ID: 24866
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24866/bond+transfer+costs+calculator
PARÂMETROS DE ENTRADA

Calculadora de Custos de Transferência de Títulos — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"property_price":2000000,"transfer_duty":33786,"transfer_attorney_fee":{"also_known_as":"conveyancing fee","amount":40963,"is_estimate":true},"deeds_office_transfer_fee":{"amount":1738,"is_estimate":true},"lodgement_fee":52,"disbursements":{"amount":1750,"is_estimate":true},"total_transfer_costs":78289},"meta":{"tax_year":"2026/27","disclaimer":"Estimates only. Consult a qualified financial advisor before making any property or financial decisions.","cached":false,"notes":"Attorney fee includes VAT at 15% and is a guideline estimate — actual fee varies by firm. Disbursements are indicative."}}
Calculadora de Custos de Transferência de Títulos — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24866/bond+transfer+costs+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "property_price": 2000000
}'

    
Requisição

Calcula o custo de registrar um novo título hipotecário na África do Sul Inclui as taxas de advogado de registro de hipoteca com base na tarifa orientadora do LPC taxas de registro do escritório de escritura do Diário Oficial do Governo taxa de protocolo e desembolsos Calculado com base no valor da hipoteca e não no preço de compra Corpo da Solicitação: - valor_da_hipoteca (obrigatório): O valor do empréstimo em Rands Este é o valor da hipoteca e não o preço de compra do imóvel

Endpoint ID: 24867
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24867/bond+registration+costs+calculator
PARÂMETROS DE ENTRADA

Calculadora de Custos de Registro de Títulos — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"bond_amount":1800000,"bond_registration_attorney_fee":{"amount":38605.5,"is_estimate":true},"deeds_office_registration_fee":{"amount":1738,"is_estimate":true},"lodgement_fee":52,"disbursements":{"amount":1750,"is_estimate":true},"total_registration_costs":42145.5},"meta":{"tax_year":"2026/27","disclaimer":"Estimates only. Consult a qualified financial advisor before making any property or financial decisions.","cached":false,"notes":"Attorney fee includes VAT at 15% and is a guideline estimate — actual fee varies by firm. Disbursements are indicative."}}
Calculadora de Custos de Registro de Títulos — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24867/bond+registration+costs+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "bond_amount": 1800000
}'

    
Requisição

Calcula quanto de juros você economiza e quantos meses você reduz do prazo do seu financiamento ao fazer um pagamento mensal adicional além da paga padrão. Retorna meses economizados, anos economizados, juros totais originais, novos juros totais e juros totais economizados. Corpo da Solicitação: - valor_imóvel (obrigatório): Preço de compra do imóvel em Rands. - depósito (opcional): Valor do depósito em Rands. Padrão para 0 se não fornecido. - prazo_anos (obrigatório): Prazo original do empréstimo em anos. Exemplo: 20. - taxa_juro_anual (obrigatório): Taxa de juros anual como uma porcentagem. Exemplo: 10,25. - pagamento_mensal_extra (obrigatório): Valor do pagamento mensal adicional em Rands além da paga padrão.

Endpoint ID: 24868
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24868/bond+extra+payment+calculator
PARÂMETROS DE ENTRADA

Calculadora de Pagamento Extra de Títulos — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"standard_monthly_repayment":17669.58,"extra_monthly_payment":2000,"new_monthly_repayment":19669.58,"original_term_months":240,"new_term_months":179,"months_saved":61,"years_saved":5.1,"original_total_interest":2440699.2,"new_total_interest":1719136.68,"interest_saved":721562.52},"meta":{"tax_year":"2026/27","disclaimer":"Estimates only. Consult a qualified financial advisor before making any property or financial decisions.","cached":false}}
Calculadora de Pagamento Extra de Títulos — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24868/bond+extra+payment+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "property_price": 2000000,
  "deposit": 200000,
  "term_years": 20,
  "annual_interest_rate": 10.25,
  "extra_monthly_payment": 2000
}'

    
Requisição

Retorna uma análise completa dos custos para a aquisição de um imóvel na África do Sul. Combina custos de transferência, custos de registro de hipoteca e o preço do imóvel em um único custo total de aquisição. Mostra o valor mínimo em dinheiro necessário no dia da transferência, incluindo o depósito e todas as taxas. Corpo da solicitação: - property_price (obrigatório): Preço de compra do imóvel em Rands. - deposit (opcional): Valor do depósito em Rands. Por padrão, é 0 se não fornecido. Se o depósito for igual ou superior ao preço do imóvel, os custos de registro de hipoteca são omitidos.

Endpoint ID: 24869
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24869/bond+total+purchase+cost+calculator
PARÂMETROS DE ENTRADA

Calculadora de Custo Total de Compra de Títulos — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"property_price":2000000,"deposit":200000,"bond_amount":1800000,"transfer_costs":{"transfer_duty":33786,"transfer_attorney_fee":{"also_known_as":"conveyancing fee","amount":40963,"is_estimate":true},"deeds_office_transfer_fee":{"amount":1738,"is_estimate":true},"lodgement_fee":52,"disbursements":{"amount":1750,"is_estimate":true},"subtotal":78289},"registration_costs":{"bond_registration_attorney_fee":{"amount":38605.5,"is_estimate":true},"deeds_office_registration_fee":{"amount":1738,"is_estimate":true},"lodgement_fee":52,"disbursements":{"amount":1750,"is_estimate":true},"subtotal":42145.5},"total_fees":120434.5,"total_cash_required":320434.5,"total_acquisition_cost":2120434.5},"meta":{"tax_year":"2026/27","disclaimer":"Estimates only. Consult a qualified financial advisor before making any property or financial decisions.","cached":false,"notes":"Attorney fees include VAT at 15%. All fee line items are guideline estimates — actual amounts vary by firm and transaction. total_cash_required is the minimum cash needed on transfer day (deposit + all fees)."}}
Calculadora de Custo Total de Compra de Títulos — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24869/bond+total+purchase+cost+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "property_price": 2000000,
  "deposit": 200000
}'

    
Requisição

Retorna um cronograma de amortização completo mês a mês para um empréstimo habitacional sul-africano. Cada entrada mostra o valor do pagamento, a parte do principal, a parte dos juros e o saldo remanescente para cada mês do prazo do empréstimo. Inclui um resumo dos pagamentos totais, do principal total e dos juros totais. Corpo da solicitação: - preço_da_propriedade (obrigatório): Preço de compra da propriedade em Rands. - depósito (opcional): Valor do depósito em Rands. Padrão é 0 se não fornecido. - prazo_anos (obrigatório): Prazo do empréstimo em anos. Exemplo: 20. - taxa_juros_anual (obrigatório): Taxa de juros anual em porcentagem. Exemplo: 10,25.

Endpoint ID: 24870
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24870/bond+amortisation+schedule
PARÂMETROS DE ENTRADA

Tabela de Amortização de Títulos — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"schedule":[{"month":1,"payment":38466.47,"principal":23091.47,"interest":15375,"balance":1776908.53},{"month":2,"payment":38466.47,"principal":23288.71,"interest":15177.76,"balance":1753619.82},{"month":3,"payment":38466.47,"principal":23487.63,"interest":14978.84,"balance":1730132.19},{"month":4,"payment":38466.47,"principal":23688.26,"interest":14778.21,"balance":1706443.93},{"month":5,"payment":38466.47,"principal":23890.59,"interest":14575.88,"balance":1682553.34},{"month":6,"payment":38466.47,"principal":24094.66,"interest":14371.81,"balance":1658458.68},{"month":7,"payment":38466.47,"principal":24300.47,"interest":14166,"balance":1634158.21},{"month":8,"payment":38466.47,"principal":24508.04,"interest":13958.43,"balance":1609650.17},{"month":9,"payment":38466.47,"principal":24717.37,"interest":13749.1,"balance":1584932.8},{"month":10,"payment":38466.47,"principal":24928.5,"interest":13537.97,"balance":1560004.3},{"month":11,"payment":38466.47,"principal":25141.43,"interest":13325.04,"balance":1534862.87},{"month":12,"payment":38466.47,"principal":25356.18,"interest":13110.29,"balance":1509506.69},{"month":13,"payment":38466.47,"principal":25572.77,"interest":12893.7,"balance":1483933.92},{"month":14,"payment":38466.47,"principal":25791.2,"interest":12675.27,"balance":1458142.72},{"month":15,"payment":38466.47,"principal":26011.5,"interest":12454.97,"balance":1432131.22},{"month":16,"payment":38466.47,"principal":26233.68,"interest":12232.79,"balance":1405897.54},{"month":17,"payment":38466.47,"principal":26457.76,"interest":12008.71,"balance":1379439.78},{"month":18,"payment":38466.47,"principal":26683.76,"interest":11782.71,"balance":1352756.02},{"month":19,"payment":38466.47,"principal":26911.68,"interest":11554.79,"balance":1325844.34},{"month":20,"payment":38466.47,"principal":27141.55,"interest":11324.92,"balance":1298702.79},{"month":21,"payment":38466.47,"principal":27373.38,"interest":11093.09,"balance":1271329.41},{"month":22,"payment":38466.47,"principal":27607.2,"interest":10859.27,"balance":1243722.21},{"month":23,"payment":38466.47,"principal":27843.01,"interest":10623.46,"balance":1215879.2},{"month":24,"payment":38466.47,"principal":28080.84,"interest":10385.63,"balance":1187798.36},{"month":25,"payment":38466.47,"principal":28320.69,"interest":10145.78,"balance":1159477.67},{"month":26,"payment":38466.47,"principal":28562.6,"interest":9903.87,"balance":1130915.07},{"month":27,"payment":38466.47,"principal":28806.57,"interest":9659.9,"balance":1102108.5},{"month":28,"payment":38466.47,"principal":29052.63,"interest":9413.84,"balance":1073055.87},{"month":29,"payment":38466.47,"principal":29300.78,"interest":9165.69,"balance":1043755.09},{"month":30,"payment":38466.47,"principal":29551.06,"interest":8915.41,"balance":1014204.03},{"month":31,"payment":38466.47,"principal":29803.48,"interest":8662.99,"balance":984400.55},{"month":32,"payment":38466.47,"principal":30058.05,"interest":8408.42,"balance":954342.5},{"month":33,"payment":38466.47,"principal":30314.79,"interest":8151.68,"balance":924027.71},{"month":34,"payment":38466.47,"principal":30573.73,"interest":7892.74,"balance":893453.98},{"month":35,"payment":38466.47,"principal":30834.88,"interest":7631.59,"balance":862619.1},{"month":36,"payment":38466.47,"principal":31098.27,"interest":7368.2,"balance":831520.83},{"month":37,"payment":38466.47,"principal":31363.9,"interest":7102.57,"balance":800156.93},{"month":38,"payment":38466.47,"principal":31631.8,"interest":6834.67,"balance":768525.13},{"month":39,"payment":38466.47,"principal":31901.98,"interest":6564.49,"balance":736623.15},{"month":40,"payment":38466.47,"principal":32174.48,"interest":6291.99,"balance":704448.67},{"month":41,"payment":38466.47,"principal":32449.3,"interest":6017.17,"balance":671999.37},{"month":42,"payment":38466.47,"principal":32726.48,"interest":5739.99,"balance":639272.89},{"month":43,"payment":38466.47,"principal":33006.01,"interest":5460.46,"balance":606266.88},{"month":44,"payment":38466.47,"principal":33287.94,"interest":5178.53,"balance":572978.94},{"month":45,"payment":38466.47,"principal":33572.27,"interest":4894.2,"balance":539406.67},{"month":46,"payment":38466.47,"principal":33859.04,"interest":4607.43,"balance":505547.63},{"month":47,"payment":38466.47,"principal":34148.25,"interest":4318.22,"balance":471399.38},{"month":48,"payment":38466.47,"principal":34439.93,"interest":4026.54,"balance":436959.45},{"month":49,"payment":38466.47,"principal":34734.11,"interest":3732.36,"balance":402225.34},{"month":50,"payment":38466.47,"principal":35030.8,"interest":3435.67,"balance":367194.54},{"month":51,"payment":38466.47,"principal":35330.02,"interest":3136.45,"balance":331864.52},{"month":52,"payment":38466.47,"principal":35631.79,"interest":2834.68,"balance":296232.73},{"month":53,"payment":38466.47,"principal":35936.15,"interest":2530.32,"balance":260296.58},{"month":54,"payment":38466.47,"principal":36243.1,"interest":2223.37,"balance":224053.48},{"month":55,"payment":38466.47,"principal":36552.68,"interest":1913.79,"balance":187500.8},{"month":56,"payment":38466.47,"principal":36864.9,"interest":1601.57,"balance":150635.9},{"month":57,"payment":38466.47,"principal":37179.79,"interest":1286.68,"balance":113456.11},{"month":58,"payment":38466.47,"principal":37497.37,"interest":969.1,"balance":75958.74},{"month":59,"payment":38466.47,"principal":37817.66,"interest":648.81,"balance":38141.08},{"month":60,"payment":38466.87,"principal":38141.08,"interest":325.79,"balance":0}],"summary":{"total_payments":2307988.6,"total_principal":1800000,"total_interest":507988.6}},"meta":{"tax_year":"2026/27","disclaimer":"Estimates only. Consult a qualified financial advisor before making any property or financial decisions.","cached":false}}
Tabela de Amortização de Títulos — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24870/bond+amortisation+schedule' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "property_price": 2000000,
  "deposit": 200000,
  "term_years": 5,
  "annual_interest_rate": 10.25
}'

    
Requisição
Compara dois cenários de empréstimo domiciliar sul-africano lado a lado Retorna ambas as quebras de pagamento e uma comparação estruturada mostrando qual opção é mais barata no geral economia total de juros diferença de pagamento mensal e uma nota de compromisso quando a opção mais barata no geral tem pagamentos mensais mais altos Corpo do Pedido: - bond_a (obrigatório): Objeto do primeiro cenário de vínculo contendo preço_do_imóvel depósito (opcional) prazo_em_anos e taxa_de_juros_anual - bond_b (obrigatório): Objeto do segundo cenário de vínculo contendo preço_do_imóvel depósito (opcional) prazo_em_anos e taxa_de_juros_anual
Endpoint ID: 24871
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24871/bond+comparison+calculator
PARÂMETROS DE ENTRADA

Calculadora de Comparação de Títulos — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"bond_a":{"property_price":2000000,"deposit":200000,"principal":1800000,"term_years":20,"annual_interest_rate":10.25,"monthly_repayment":17669.58,"total_repayment":4240699.2,"total_interest":2440699.2},"bond_b":{"property_price":2000000,"deposit":200000,"principal":1800000,"term_years":15,"annual_interest_rate":10.25,"monthly_repayment":19619.12,"total_repayment":3531441.6,"total_interest":1731441.6},"comparison":{"cheaper_option":"bond_b","total_saving":709257.6,"monthly_difference":1949.54,"note":"Bond B costs less overall but has higher monthly repayments. Bond A is cheaper month-to-month but costs more in total interest."}},"meta":{"tax_year":"2026/27","disclaimer":"Estimates only. Consult a qualified financial advisor before making any property or financial decisions.","cached":false}}
Calculadora de Comparação de Títulos — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24871/bond+comparison+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "bond_a": {
    "property_price": 2000000,
    "deposit": 200000,
    "term_years": 20,
    "annual_interest_rate": 10.25
  },
  "bond_b": {
    "property_price": 2000000,
    "deposit": 200000,
    "term_years": 15,
    "annual_interest_rate": 10.25
  }
}'

    
Requisição
Retorna a taxa de juro prime atual da África do Sul conforme publicado pelo Banco Reserva Sul-Africano A taxa é extraída diariamente e persistida em um banco de dados Se a extração ao vivo falhar o último valor persistido com sucesso é retornado A resposta inclui um carimbo de hora da extração e uma bandeira de fallback indicando se um valor em cache ou de configuração foi utilizado Nenhum parâmetro necessário
Endpoint ID: 24872
GET https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24872/sarb+prime+lending+rate
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"prime_rate":10.25,"scraped_at":"2026-05-29T08:41:39.201Z","fallback":false},"meta":{"disclaimer":"Estimates only. Consult a qualified financial advisor before making any property or financial decisions.","cached":false}}
Taxa de Juros Prime do SARB — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24872/sarb+prime+lending+rate' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição

Calcula o pagamento mensal do empréstimo de carro para um acordo de financiamento de veículos sul-africano. Suporta um pagamento de balão opcional. Se um pagamento de balão for especificado, ele é excluído do cálculo do pagamento mensal, mas permanece devido como uma quantia única no final do prazo. Um campo de aviso é incluído na resposta sempre que um pagamento de balão estiver presente. Corpo do Pedido: - preço_do_veículo (obrigatório): Preço de compra do veículo em Rands. - depósito (opcional): Valor do depósito em Rands. O padrão é 0 se não for fornecido. - prazo_meses (obrigatório): Prazo do empréstimo em meses. Exemplo: 72. - taxa_de_juros_anual (obrigatório): Taxa de juros anual como porcentagem. Exemplo: 11,5. - pagamento_de_balão (opcional): Valor do pagamento de balão em Rands. O padrão é 0 se não for fornecido.

Endpoint ID: 24873
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24873/vehicle+repayment+calculator
PARÂMETROS DE ENTRADA

Calculadora de Reembolso de Veículo — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"vehicle_price":500000,"deposit":50000,"loan_amount":450000,"monthly_repayment":7952.93,"term_months":72,"annual_interest_rate":11.5,"balloon_payment":75000,"warning":"Balloon amount of R75 000,00 is still owed at end of term and is not included in monthly repayment"},"meta":{"disclaimer":"Estimates only. Consult a qualified financial advisor before making any vehicle finance decisions.","cached":false}}
Calculadora de Reembolso de Veículo — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24873/vehicle+repayment+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "vehicle_price": 500000,
  "deposit": 50000,
  "term_months": 72,
  "annual_interest_rate": 11.5,
  "balloon_payment": 75000
}'

    
Requisição
Calcula o preço máximo do veículo que um comprador pode pagar com base em um orçamento mensal Suporta um pagamento balão opcional Não inclui custos adicionais de propriedade como seguro licenciamento ou combustível Corpo da Requisição: - mensal_orcamento (obrigatório): Orçamento máximo de reembolso mensal em Rands - deposito (opcional): Quantia de depósito disponível em Rands Se não fornecido o padrão é 0 - prazo_meses (obrigatório): Prazo do empréstimo em meses Exemplo 72 - taxa_juros_anual (obrigatório): Taxa de juros anual em porcentagem Exemplo 11,5 - pagamento_balão (opcional): Quantia do pagamento balão em Rands Se não fornecido o padrão é 0
Endpoint ID: 24874
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24874/vehicle+affordability+calculator
PARÂMETROS DE ENTRADA

Calculadora de Acessibilidade de Veículos — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"max_vehicle_price":464697.8,"max_loan_amount":414697.8,"monthly_budget":8000,"deposit":50000,"term_months":72,"annual_interest_rate":11.5},"meta":{"disclaimer":"Estimates only. Consult a qualified financial advisor before making any vehicle finance decisions.","cached":false,"notes":"Max vehicle price is the maximum that can be financed at the given monthly budget. Additional costs (insurance, licensing, fuel) are not included."}}
Calculadora de Acessibilidade de Veículos — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24874/vehicle+affordability+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "monthly_budget": 8000,
  "deposit": 50000,
  "term_months": 72,
  "annual_interest_rate": 11.5
}'

    
Requisição

Calcula o custo total de possuir um veículo financiado na África do Sul Inclui todos os pagamentos mensais o total de juros pagos e o pagamento de balão se aplicável O total de juros é calculado apenas sobre a parte amortizada e o pagamento de balão é apresentado separadamente como principal diferido Corpo da solicitação: - preço_veículo (obrigatório): Preço de compra do veículo em Rands - depósito (opcional): Valor do depósito em Rands Padrão para 0 se não fornecido - prazo_meses (obrigatório): Prazo do empréstimo em meses Exemplo: 72 - taxa_juros_anual (obrigatório): Taxa de juros anual em porcentagem Exemplo: 11,5 - pagamento_balão (opcional): Valor do pagamento de balão em Rands Padrão para 0 se não fornecido

Endpoint ID: 24875
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24875/vehicle+total+cost+of+ownership
PARÂMETROS DE ENTRADA

Custo Total de Propriedade do Veículo — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"vehicle_price":500000,"deposit":50000,"loan_amount":450000,"monthly_repayment":8681.02,"term_months":72,"annual_interest_rate":11.5,"total_repayments":625033.44,"total_interest":175033.44,"total_cost_of_ownership":675033.44},"meta":{"disclaimer":"Estimates only. Consult a qualified financial advisor before making any vehicle finance decisions.","cached":false,"notes":"total_interest reflects the financing cost on the amortised portion only. balloon_payment is deferred principal and is surfaced separately. total_cost_of_ownership = deposit + total_repayments + balloon_payment."}}
Custo Total de Propriedade do Veículo — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24875/vehicle+total+cost+of+ownership' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "vehicle_price": 500000,
  "deposit": 50000,
  "term_months": 72,
  "annual_interest_rate": 11.5
}'

    
Requisição

Compara dois cenários de financiamento de veículos na África do Sul lado a lado. Retorna tanto a discriminação dos pagamentos quanto uma comparação estruturada mostrando qual opção é mais barata no geral com base no custo total de propriedade, economia total, diferença de pagamento mensal e uma nota de comprometimento quando aplicável. Suporta pagamentos balloon opcionais em qualquer um dos veículos. Corpo da solicitação: - vehicle_a (obrigatório): Objeto do primeiro cenário de veículo contendo vehicle_price, depósito (opcional), term_months, annual_interest_rate e balloon_payment (opcional). - vehicle_b (obrigatório): Objeto do segundo cenário de veículo contendo vehicle_price, depósito (opcional), term_months, annual_interest_rate e balloon_payment (opcional).

Endpoint ID: 24876
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24876/vehicle+comparison+calculator
PARÂMETROS DE ENTRADA

Calculadora de Comparação de Veículos — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"vehicle_a":{"vehicle_price":500000,"deposit":50000,"loan_amount":450000,"term_months":72,"annual_interest_rate":11.5,"monthly_repayment":8681.02,"total_repayments":625033.44,"total_interest":175033.44,"total_cost_of_ownership":675033.44},"vehicle_b":{"vehicle_price":500000,"deposit":50000,"loan_amount":450000,"term_months":60,"annual_interest_rate":11.5,"monthly_repayment":9896.67,"total_repayments":593800.2,"total_interest":143800.2,"total_cost_of_ownership":643800.2},"comparison":{"cheaper_option":"vehicle_b","total_saving":31233.24,"monthly_difference":1215.65,"note":"Vehicle B costs less overall but has higher monthly repayments. Vehicle A is cheaper month-to-month but costs more in total."}},"meta":{"disclaimer":"Estimates only. Consult a qualified financial advisor before making any vehicle finance decisions.","cached":false}}
Calculadora de Comparação de Veículos — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24876/vehicle+comparison+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "vehicle_a": {
    "vehicle_price": 500000,
    "deposit": 50000,
    "term_months": 72,
    "annual_interest_rate": 11.5
  },
  "vehicle_b": {
    "vehicle_price": 500000,
    "deposit": 50000,
    "term_months": 60,
    "annual_interest_rate": 11.5
  }
}'

    
Requisição

Calcula o imposto de renda PAYE sul-africano completo, UIF, SDL e créditos fiscais de auxílio médico para o ano fiscal de 2026/27. Retorna desagregações mensais e anuais para as contribuições de empregados e empregadores. A idade determina qual reembolso se aplica e os membros do plano de saúde determinam a dedução do crédito fiscal mensal. Corpo da solicitação: - renda_anual (obrigatório): Renda bruta anual em Rands antes de qualquer dedução. - idade (obrigatório): Idade do contribuinte. Determina se se aplica reembolso primário, secundário (65 anos ou mais) ou terciário (75 anos ou mais). - membros_do_ausílio_médico (opcional): Número total de membros do auxílio médico incluindo o membro principal. O padrão é 0 se não fornecido.

Endpoint ID: 24877
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24877/paye+income+tax+calculator
PARÂMETROS DE ENTRADA

Calculadora de Imposto de Renda PAYE — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"annual_income":480000,"monthly_income":40000,"tax_year":"2026/27","gross_income_tax":{"annual":110037,"monthly":9169.75},"rebate":{"primary":17820,"secondary":0,"tertiary":0,"total":17820},"income_tax":{"annual":80145,"monthly":6678.75},"uif":{"employee_monthly":177.12,"employer_monthly":177.12,"ceiling_applied":true},"sdl":{"monthly":400,"note":"Employer levy — not deducted from employee salary. Payable only if employer annual payroll exceeds R500,000."},"effective_tax_rate":0.167,"net_monthly_income":33144.13,"medical_aid_tax_credit":{"members":3,"monthly":1006,"annual":12072}},"meta":{"disclaimer":"Estimates only. Consult a registered tax practitioner before making any tax decisions.","cached":false,"notes":"PAYE calculated on gross annual income before any other deductions (e.g. pension, retirement annuity). Net monthly income reflects salary after income tax and employee UIF contribution only."}}
Calculadora de Imposto de Renda PAYE — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24877/paye+income+tax+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "annual_income": 480000,
  "age": 35,
  "medical_aid_members": 3
}'

    
Requisição
Calcula o salário líquido para um empregado sul-africano Retorna um salário líquido mensal limpo após deduções de imposto de renda e UIF Saída mais simples do que a API completa de PAYE projetada para cálculos rápidos de salário sem a quebra completa de impostos Não são incluídas outras deduções como pensão anuidade de aposentadoria ou prêmio de assistências médicas Corpo da solicitação - renda_anual (obrigatório) Renda bruta anual em Rands antes de quaisquer deduções - idade (obrigatório) Idade do contribuinte Determina qual desconto se aplica - membros_do_plano_de_saúde (opcional) Número total de membros do plano de saúde Padrão é 0 se não fornecido
Endpoint ID: 24878
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24878/net+salary+calculator
PARÂMETROS DE ENTRADA

Calculadora de Salário Líquido — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"gross_monthly":40000,"tax_monthly":6678.75,"uif_monthly":177.12,"net_monthly":33144.13},"meta":{"disclaimer":"Estimates only. Consult a registered tax practitioner before making any tax decisions.","cached":false,"notes":"Take-home pay after income tax and employee UIF contribution only. No other deductions (pension, retirement annuity, medical aid premium) are applied."}}
Calculadora de Salário Líquido — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24878/net+salary+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "annual_income": 480000,
  "age": 35,
  "medical_aid_members": 3
}'

    
Requisição

Calcula o imposto a pagar sobre um bônus anual utilizando o método de média da SARS. O imposto sobre o bônus é calculado como o imposto sobre a renda total mais o bônus menos o imposto sobre a renda apenas. Retorna o bônus líquido após o imposto e a taxa efetiva de imposto sobre o bônus. Corpo do Pedido: - renda_anual (obrigatório): Renda bruta anual em Rands antes do bônus. - valor_do_bônus (obrigatório): Montante do bônus em Rands. - idade (obrigatório): Idade do contribuinte. Determina qual desconto se aplica. - membros_de_plano_de_saúde (opcional): Número total de membros de plano de saúde. Padrão é 0 se não fornecido.

Endpoint ID: 24879
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24879/annual+bonus+tax+calculator
PARÂMETROS DE ENTRADA

Calculadora de Imposto sobre Bônus Anual — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"bonus_amount":50000,"tax_on_bonus":15500,"net_bonus":34500,"effective_bonus_tax_rate":0.31},"meta":{"disclaimer":"Estimates only. Consult a registered tax practitioner before making any tax decisions.","cached":false,"notes":"Tax on bonus uses the SARS averaging method: tax on (annual income + bonus) minus tax on annual income. Result may differ if employer uses a different method or if other deductions apply."}}
Calculadora de Imposto sobre Bônus Anual — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24879/annual+bonus+tax+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "annual_income": 480000,
  "bonus_amount": 50000,
  "age": 35
}'

    
Requisição
Retorna as faixas de imposto de renda da África do Sul, descontos, limites de imposto e créditos fiscais de assistência médica para um determinado ano fiscal. Os anos disponíveis são 2023, 2024, 2025 e 2026. Se o ano solicitado não estiver disponível, a resposta inclui uma lista de anos disponíveis Parâmetros da consulta: - ano (obrigatório): O ano fiscal a ser recuperado. Use o ano em que o ano fiscal termina. Exemplo: 2026 para o ano fiscal 2026/27 que vai de 1 de março de 2026 a 28 de fevereiro de 2027
Endpoint ID: 24880
GET https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24880/tax+brackets+by+year
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"tax_year":"2026/27","effective_date":"2026-03-01","income_tax_brackets":[{"from":0,"to":245100,"threshold":0,"base_tax":0,"rate":0.18},{"from":245101,"to":383100,"threshold":245100,"base_tax":44118,"rate":0.26},{"from":383101,"to":530200,"threshold":383100,"base_tax":79998,"rate":0.31},{"from":530201,"to":695800,"threshold":530200,"base_tax":125599,"rate":0.36},{"from":695801,"to":887000,"threshold":695800,"base_tax":185215,"rate":0.39},{"from":887001,"to":1878600,"threshold":887000,"base_tax":259783,"rate":0.41},{"from":1878601,"to":null,"threshold":1878600,"base_tax":666339,"rate":0.45}],"rebates":{"primary":17820,"secondary":9765,"tertiary":3249},"tax_thresholds":{"under_65":99000,"age_65_to_74":153250,"age_75_and_over":171300},"medical_aid_tax_credits":{"main_member_monthly":376,"first_dependant_monthly":376,"additional_dependant_monthly":254}},"meta":{"disclaimer":"Estimates only. Consult a registered tax practitioner before making any tax decisions.","cached":false}}
Faixas de Imposto por Ano — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24880/tax+brackets+by+year' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Retorna as atuais taxas de impostos sul-africanas incluindo a taxa de IVA e porcentagem as taxas de contribuição do UIF para empregado e empregador os tetos de remuneração mensal e anual do UIF a taxa do SDL e o limite de isenção anual da folha de pagamento do SDL Essas taxas são legisladas e raramente mudam
Endpoint ID: 24881
GET https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24881/current+tax+rates
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"vat":{"rate":0.15,"percentage":15},"uif":{"employee_rate":0.01,"employer_rate":0.01,"monthly_remuneration_ceiling":17712,"annual_remuneration_ceiling":212544},"sdl":{"rate":0.01,"annual_payroll_exemption_threshold":500000}},"meta":{"disclaimer":"Estimates only. Consult a registered tax practitioner before making any tax decisions.","cached":false}}
Taxas de Impostos Atuais — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24881/current+tax+rates' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição

Adiciona ou remove o IVA sul-africano de 15 por cento de qualquer quantia. Use o modo adicionar para converter um valor sem IVA em um valor com IVA. Use o modo remover para extrair o preço sem IVA de um valor com IVA. Corpo da Solicitação: - quantia (obrigatório): A quantia em Rands à qual aplicar o IVA. - modo (obrigatório): A direção do cálculo. Use adicionar para calcular o preço com IVA a partir de um valor exclusivo. Use remover para extrair o preço sem IVA de um valor inclusivo.

Endpoint ID: 24882
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24882/vat+calculator
PARÂMETROS DE ENTRADA

Calculadora de IVA — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"mode":"add","amount_exclusive":1000,"vat_amount":150,"amount_inclusive":1150,"vat_rate":0.15},"meta":{"disclaimer":"Estimates only. Consult a registered tax practitioner before making any tax decisions.","cached":false}}
Calculadora de IVA — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24882/vat+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "amount": 1000,
  "mode": "add"
}'

    
Requisição
Calcula o imposto sul-africano a pagar sobre um montante de resgate de fundo de aposentadoria utilizando as tabelas de imposto sobre montantes de resgate do SARS para o ano fiscal de 2026/27 Suporta tanto montantes de resgate retirados na aposentadoria quanto retiradas antecipadas antes da aposentadoria O imposto é calculado assumindo que este é o primeiro montante de resgate retirado uma vez que o SARS agrega todos os montantes de resgate anteriores ao longo da vida Corpo da Solicitação: - montante_resgate (obrigatório): O montante do resgate em Rands - tipo (obrigatório): O tipo de retirada Use na_aposentadoria para montantes de resgate retirados na aposentadoria Use retirada para retiradas antecipadas antes da aposentadoria
Endpoint ID: 24883
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24883/retirement+lump+sum+tax+calculator
PARÂMETROS DE ENTRADA

Calculadora de Imposto de Montante Único de Aposentadoria — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"lump_sum":800000,"type":"at_retirement","tax_payable":47700,"net_lump_sum":752300,"effective_tax_rate":0.0596,"tax_year":"2026/27"},"meta":{"disclaimer":"Estimates only. Consult a registered tax practitioner before making any tax decisions.","cached":false,"notes":"Tax is calculated on the assumption this is the first lump sum taken. SARS aggregates all prior lump sums in a lifetime — prior withdrawals may push this amount into a higher bracket. Consult a retirement specialist."}}
Calculadora de Imposto de Montante Único de Aposentadoria — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24883/retirement+lump+sum+tax+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "lump_sum": 800000,
  "type": "at_retirement"
}'

    
Requisição
Retorna o crédito fiscal mensal e anual de auxílio médico para um determinado número de membros de auxílio médico usando as taxas atuais da SARS 2026/27 Os créditos reduzem o PAYE a ser pago e não são um reembolso em dinheiro Útil para ferramentas de RH e sistemas de folha de pagamento que precisam calcular o crédito de auxílio médico de forma independente Parâmetros da Consulta - membros (obrigatório) Número total de membros de auxílio médico incluindo o membro principal e todos os dependentes Exemplo 3
Endpoint ID: 24884
GET https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24884/medical+aid+tax+credits
PARÂMETROS DE ENTRADA

Créditos Fiscais de Ajuda Médica — Recursos do endpoint

Objeto Descrição
members Obrigatório Required. Total number of medical aid members including main member and all dependants.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

members
RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"members":3,"monthly_credit":1006,"annual_credit":12072,"rates":{"main_member_monthly":376,"first_dependant_monthly":376,"additional_dependant_monthly":254}},"meta":{"disclaimer":"Estimates only. Consult a registered tax practitioner before making any tax decisions.","cached":false,"notes":"Medical aid tax credits for tax year 2026/27. Credits reduce PAYE payable — they are not a cash refund."}}
Créditos Fiscais de Ajuda Médica — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24884/medical+aid+tax+credits?members=3' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição

Compare dois anos fiscais sul-africanos lado a lado e veja as diferenças nas faixas de imposto de renda, reembolsos fiscais, limites de imposto e créditos fiscais para assistência médica Este endpoint ajuda os usuários a entender como as regras fiscais e as mudanças orçamentárias evoluíram entre os anos e como podem impactar a posição de um contribuinte

Anos fiscais disponíveis: 2023 2024 2025 e 2026

Endpoint ID: 24885
GET https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24885/tax+year+comparison
PARÂMETROS DE ENTRADA

Comparação de Ano Fiscal — Recursos do endpoint

Objeto Descrição
year1 Obrigatório Required. First tax year to compare. Accepted values: 2023, 2024, 2025, 2026.
year2 Obrigatório Required. Second tax year to compare. Accepted values: 2023, 2024, 2025, 2026.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

year1
year2
RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"years_compared":["2023","2026"],"income_tax_brackets":[{"2023":{"from":0,"to":226000},"2026":{"from":0,"to":245100},"bracket":1,"rate":0.18},{"2023":{"from":226001,"to":353100},"2026":{"from":245101,"to":383100},"bracket":2,"rate":0.26},{"2023":{"from":353101,"to":488700},"2026":{"from":383101,"to":530200},"bracket":3,"rate":0.31},{"2023":{"from":488701,"to":641400},"2026":{"from":530201,"to":695800},"bracket":4,"rate":0.36},{"2023":{"from":641401,"to":817600},"2026":{"from":695801,"to":887000},"bracket":5,"rate":0.39},{"2023":{"from":817601,"to":1731600},"2026":{"from":887001,"to":1878600},"bracket":6,"rate":0.41},{"2023":{"from":1731601,"to":null},"2026":{"from":1878601,"to":null},"bracket":7,"rate":0.45}],"rebates":{"primary":{"2023":16425,"2026":17820,"difference":1395},"secondary":{"2023":9000,"2026":9765,"difference":765},"tertiary":{"2023":2997,"2026":3249,"difference":252}},"tax_thresholds":{"under_65":{"2023":91250,"2026":99000,"difference":7750},"age_65_to_74":{"2023":141250,"2026":153250,"difference":12000},"age_75_and_over":{"2023":157900,"2026":171300,"difference":13400}},"medical_aid_tax_credits":{"main_member_monthly":{"2023":347,"2026":376,"difference":29},"first_dependant_monthly":{"2023":347,"2026":376,"difference":29},"additional_dependant_monthly":{"2023":234,"2026":254,"difference":20}}},"meta":{"disclaimer":"Estimates only. Consult a registered tax practitioner before making any tax decisions.","cached":false,"notes":"Comparison of tax year 2023/24 (effective 2023-03-01) vs 2026/27 (effective 2026-03-01). Differences are year2 minus year1."}}
Comparação de Ano Fiscal — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24885/tax+year+comparison?year1=2023&year2=2026' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição

Calcula o reembolso mensal, o reembolso total e o total de juros para um empréstimo pessoal sul-africano usando amortização padrão. Retorna uma análise completa, incluindo principal, prazo, taxa de juros e custo total do empréstimo. Corpo do pedido: - principal (obrigatório): Valor do empréstimo em Rands. - term_months (obrigatório): Prazo do empréstimo em meses. Exemplo: 60. - annual_interest_rate (obrigatório): Taxa de juros anual em forma de porcentagem. Exemplo: 13,5.

Endpoint ID: 24886
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24886/personal+loan+repayment+calculator
PARÂMETROS DE ENTRADA

Calculadora de Reembolso de Empréstimo Pessoal — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"principal":150000,"term_months":60,"annual_interest_rate":13.5,"monthly_repayment":3451.48,"total_repayment":207088.8,"total_interest":57088.8},"meta":{"disclaimer":"Estimates only. Consult a qualified financial advisor before making any financial decisions.","cached":false}}
Calculadora de Reembolso de Empréstimo Pessoal — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24886/personal+loan+repayment+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "principal": 150000,
  "term_months": 60,
  "annual_interest_rate": 13.5
}'

    
Requisição
Compara dois cenários de empréstimo pessoal da África do Sul lado a lado Retorna tanto os detalhes do empréstimo quanto uma comparação estruturada mostrando qual opção é mais barata no geral a economia total de juros a diferença nos pagamentos mensais e uma nota de troca quando o empréstimo mais barato no geral tem parcelas mensais mais altas
Endpoint ID: 24887
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24887/loan+comparison+calculator
PARÂMETROS DE ENTRADA

Calculadora de Comparação de Empréstimos — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"loan_a":{"principal":150000,"term_months":60,"annual_interest_rate":13.5,"monthly_repayment":3451.48,"total_repayment":207088.8,"total_interest":57088.8},"loan_b":{"principal":150000,"term_months":48,"annual_interest_rate":13.5,"monthly_repayment":4061.45,"total_repayment":194949.6,"total_interest":44949.6},"comparison":{"cheaper_option":"b","total_saving":12139.2,"monthly_difference":609.97,"note":"Loan B costs less overall but has higher monthly repayments. Loan A is cheaper month-to-month but costs more in total interest."}},"meta":{"disclaimer":"Estimates only. Consult a qualified financial advisor before making any financial decisions.","cached":false}}
Calculadora de Comparação de Empréstimos — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24887/loan+comparison+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "loan_a": {
    "principal": 150000,
    "term_months": 60,
    "annual_interest_rate": 13.5
  },
  "loan_b": {
    "principal": 150000,
    "term_months": 48,
    "annual_interest_rate": 13.5
  }
}'

    
Requisição
Calcula o valor futuro de um montante em Rands após um determinado número de anos usando a inflação do IPC sul-africano Mostra quanto do poder de compra é perdido ao longo do tempo Usa a taxa atual do IPC da África do Sul do Stats SA por padrão Suporta uma taxa de substituição opcional para modelar um cenário de inflação personalizado Corpo da solicitação: - montante (obrigatório): Montante do valor presente em Rands - anos (obrigatório): Número de anos para projetar para frente Deve ser um número inteiro positivo - taxa_de_substituição (opcional): Taxa de inflação personalizada como um decimal Exemplo 0 06 para 6 por cento Se não for fornecida a taxa atual do IPC da África do Sul do Stats SA é usada
Endpoint ID: 24888
POST https://docs.zylalabs.com/api/12762/sa+financial+calculators+api/24888/inflation+future+value+calculator
PARÂMETROS DE ENTRADA

Calculadora de Valor Futuro da Inflação — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{"success":true,"data":{"present_value":100000,"future_value":148024.43,"increase":48024.43,"inflation_rate":0.04,"years":10,"rate_source":"SA CPI (Stats SA)"},"meta":{"disclaimer":"Estimates only. Consult a qualified financial advisor before making any financial decisions.","cached":false,"notes":"SA CPI rate of 4.00% used (April 2026). Update config/rates.json to reflect the latest Stats SA release."}}
Calculadora de Valor Futuro da Inflação — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/12762/sa+financial+calculators+api/24888/inflation+future+value+calculator' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "amount": 100000,
  "years": 10
}'

    

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Calculadoras Financeiras SA API basta incluir seu token Bearer no cabeçalho Authorization.

Cabeçalhos
Cabeçalho Descrição
Authorization Obrigatório Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.

(Economize 2 meses com cobrança anual 🎉)

🚀 Plano Empresarial

A partir de
$ 10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real
zeiss-logo amazon-logo zoom-logo decathlon-logo

Empresas líderes confiam em nós

Visão Geral

Um conjunto abrangente de calculadoras financeiras sul-africanas cobrindo custos de imóveis e títulos, financiamento de veículos, imposto PAYE, VAT, valores de aposentadoria, empréstimos pessoais e inflação. Todos os valores monetários em ZAR. Cobre 25 pontos finais em módulos de título, veículo, impostos e finanças pessoais. Dados obtidos da SARS, LPC, Diário Oficial, SARB e Stats SA.

Calculadoras Financeiras SA API FAQs

Todas as entradas e saídas monetárias estão em Rand sul-africano (ZAR) Não passe valores em centavos - sempre use quantias inteiras em Rand

Todos os resultados são estimativas para fins informativos apenas Os honorários advocatícios as taxas do cartório e o imposto de transmissão são calculados usando tabelas oficiais publicadas mas os valores reais podem variar de acordo com a transação Cada resposta inclui um aviso no campo meta

Todos os cálculos fiscais usam o ano fiscal de 2026/27 (1 de março de 2026 a 28 de fevereiro de 2027) por padrão, com base no anúncio do orçamento mais recente da SARS. As faixas históricas para 2023, 2024 e 2025 estão disponíveis por meio dos terminais de Faixas Fiscais e Comparação de Anos Fiscais

A taxa de juros prime é extraída diariamente do Banco da Reserva da África do Sul (resbank.co.za) e persistida em um banco de dados O endpoint GET /bond/prime-rate sempre retorna a taxa mais recentemente confirmada juntamente com um carimbo de data/hora de extração Se a extração ao vivo falhar, o último valor persistido com sucesso é usado e flagback: true é incluído na resposta

As taxas de advogado de transferência (também conhecidas como taxas de escritura) e as taxas de advogado de registro de hipoteca são calculadas usando a tabela tarifária incremental da LSSA com vigência a partir de 1 de agosto de 2025. A fórmula é taxa base mais incrementos por unidade ou fração dela, arredondada para cima. Todos os valores das taxas de advogado incluem IVA de 15% e estão marcados como is_estimate: true, pois as taxas reais são negociáveis e variam de acordo com o escritório

Os custos de transferência cobrem as taxas para transferir a propriedade do vendedor para o comprador - incluindo imposto de transferência, honorários do advogado de transferência e taxa de transferência do cartório de registro. Os custos de registro cobrem as taxas para registrar a nova hipoteca - incluindo honorários do advogado de registro da hipoteca e taxa de registro do cartório. O endpoint /bond/total-purchase-cost combina ambos em uma única discriminação

Um pagamento balloon reduz o valor sendo amortizado a cada mês resultando em pagamentos mensais mais baixos No entanto o valor total do balloon permanece devido como um pagamento único ao final do prazo de financiamento e não está incluído no pagamento mensal Toda resposta que inclui um pagamento balloon inclui um campo de aviso tornando isso explícito

O método de média SARS é utilizado O imposto é calculado sobre a renda total mais o bônus então o imposto sobre a renda isoladamente é subtraído A diferença é o imposto sobre o bônus Isso corresponde ao método que a maioria dos empregadores sul-africanos usa para fins de folha de pagamento

- Faixas de imposto e taxa de transferência: atualizadas em fevereiro após o discurso orçado anual - Taxas do cartório de registro: atualizadas em abril após a publicação no Diário Oficial do Governo - Tarifa de advogado LPC: atualizada em agosto após a publicação da diretriz LSSA - Taxa de juros prime: atualizada diariamente via scraper após cada decisão da MPC do SARB

A API é adequada para exibir estimativas, construir calculadoras e ferramentas informativas. Não é um substituto para aconselhamento profissional financeiro, tributário ou legal. Todos os resultados devem ser apresentados claramente como estimativas aos usuários finais. O campo de isenção de responsabilidade em cada bloco de meta resposta é fornecido para esse fim

Cada ponto final retorna dados JSON estruturados para fornecer cálculos ou informações financeiras específicas Por exemplo, o Calculador de Reembolso de Títulos retorna valores mensais de reembolso total de reembolso e detalhes de juros enquanto o Calculador de Imposto de Renda PAYE fornece detalhamentos de impostos e números de renda líquida

Os campos principais variam de acordo com o ponto final, mas geralmente incluem "sucesso", "dados" e "meta". Por exemplo, o Calculador de Reembolso de Títulos inclui campos como "reembolso_mensal", "juros_totais" e "anos_de_duração", enquanto o campo meta fornece informações de origem e avisos.

Cada endpoint possui parâmetros específicos Por exemplo, o Calculador de Reembolso de Obligações requer "preço_imóvel", "anos_contrato" e "taxa_juros_anual" Parâmetros opcionais como "depósito" também podem ser incluídos Consulte a documentação de cada endpoint para requisitos detalhados dos parâmetros

Os dados da resposta estão organizados em um formato JSON estruturado O objeto "data" contém os resultados do cálculo enquanto o objeto "meta" inclui informações adicionais como a fonte dos dados e os avisos Essa estrutura permite uma fácil análise e utilização dos resultados

Os dados são provenientes de instituições sul-africanas respeitáveis, incluindo a SARS, LPC, Diário Oficial, SARB e Stats SA. Isso garante que os cálculos e as informações fornecidas sejam baseados em dados oficiais e atuais, aumentando a confiabilidade

Casos de uso típicos incluem planejamento financeiro avaliações de hipoteca cálculos de impostos e cenários de financiamento de veículos Os usuários podem aproveitar a API para construir calculadoras para aplicações de finanças pessoais ajudando indivíduos a tomar decisões financeiras informadas

Os usuários podem personalizar solicitações fornecendo parâmetros específicos relevantes para suas necessidades Por exemplo no Calculador de Acessibilidade de Veículos os usuários podem ajustar "orçamento_mensal" "depósito" e "prazo_meses" para refletir sua situação financeira e preferências

Os usuários podem utilizar os dados retornados integrando-os a aplicativos financeiros ou calculadoras Por exemplo o Calculador de Comparação de Títulos fornece uma comparação estruturada de dois cenários permitindo que os usuários identifiquem facilmente a opção mais econômica com base nos juros totais e nos pagamentos mensais

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas